API Reference / Endpoints

Publish Landing Page

Publishes the draft landing page to https://waitlister.me/p/{slug} (or the waitlist's active custom domain, if one is configured). Available on every plan with an account API key.

Before publishing, the page is validated: it must contain an email field and a submit button (always true for API-created pages), and a headline of at least 3 characters.

Endpoint Details

URL: https://waitlister.me/api/v1/waitlist/{waitlistKey}/landing-page/publish
Method: POST

Request

Body Parameters

Parameter	Type	Required	Description
`unpublish`	Boolean	No	`true` takes the page offline (status becomes `unpublished`)

Example Request

bash

curl -X POST "https://waitlister.me/api/v1/waitlist/WAITLIST_KEY/landing-page/publish" \
  -H "X-Api-Key: wl_acct_your-account-api-key"

Response

Success Response `200`

json

{
  "success": true,
  "data": {
    "status": "published",
    "hosted_page_url": "https://waitlister.me/p/my-product",
    "notes": "Published without a custom social-share (OG) image — publishing once from the dashboard generates one."
  }
}

The edge cache is purged automatically, so the page (and later PATCH updates) are live right away.

API publishes skip the custom social-share (OG) image — the page renders and shares fine without one, and publishing once from the dashboard generates it.

Error Responses

Status Code	Description
`401`	Missing or invalid API key / waitlist key
`404`	No landing page yet — create one first
`422`	Validation failed — missing form elements, or headline shorter than 3 characters. The message says what to fix
`429`	Rate limit exceeded (3/min; 5/min on Growth+)
`503`	The landing-page API is temporarily disabled