API Reference / Endpoints

Generate Landing Page (AI)

Generates a complete, custom-designed landing page from a natural-language prompt — the same AI builder the dashboard uses, with the same prompts, guardrails, and quality bar. With is_edit, it edits the existing AI page instead ("change the headline", "make it dark", …).

The result is saved as a draft — review it in the dashboard or go live via Publish Landing Page. The AI conversation is saved too, so the dashboard's AI chat picks up exactly where the agent left off.

Costs 1 AI credit per call, from the same balance as the dashboard AI builder (the free plan includes a few one-time credits; paid plans include monthly credits).

Endpoint Details

• URL: https://waitlister.me/api/v1/waitlist/{waitlistKey}/landing-page/generate
• Method: POST
• Timing: synchronous — typically 20–50 seconds

Request

Body Parameters

Example Request

curl -X POST "https://waitlister.me/api/v1/waitlist/WAITLIST_KEY/landing-page/generate" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: wl_acct_your-account-api-key" \
  -d '{ "prompt": "Dark, bold, dev-tool aesthetic. Emphasize the CLI-first workflow." }'

Response

Success Response 200

{
  "success": true,
  "data": {
    "status": "draft",
    "page_type": "ai",
    "preview": {
      "title": "Ship faster from your terminal",
      "description": "A dark, bold dev-tool landing page",
      "style": "bold",
      "primary_color": "#22d3ee"
    },
    "credits_remaining": 4,
    "note": "Draft updated — review at https://waitlister.me/waitlist/my-product/landing-page or publish via POST /api/v1/waitlist/{waitlistKey}/landing-page/publish"
  }
}

After Generating

The page is now an AI page: structured copy fields on Update Landing Page return 409 (the copy lives inside the generated page) — make copy changes with another generate call using is_edit: true. theme and seo can still be PATCHed normally.

Error Responses