Getting started
Quickstart
Go from zero to collecting signups in about five minutes. You'll create a waitlist, pick one of four ways to go live, and verify your first signup.
Everything on this page in one fetchable file: the one-page integration guide has copy-paste code for every path below (ideal for AI agents) · OpenAPI spec · SDK: npm install waitlister
1. Create your waitlist
- Create a free account — no credit card needed.
- Create a waitlist (the setup wizard takes a minute — details here).
- Note your waitlist key, shown at the top of the waitlist's Overview page. You'll need it for options C and D below.
2. Pick how you'll collect signups
Option A — hosted landing page (no code, fastest)
Waitlister hosts a full landing page for you. Customize it in the drag-and-drop editor (or generate one with the AI page builder), hit publish, and share the URL. Done — you can stop reading here.
Option B — embed a form on your site
Add a Waitlister form to a page you already have with a copy-paste embed snippet. Works on any site that allows scripts. Set up the embeddable form →
Option C — point any HTML form at Waitlister
Keep full control of your design: any form can submit straight to Waitlister. Perfect for Webflow, Framer, Wix, or hand-written HTML.
<form action="https://waitlister.me/s/YOUR_WAITLIST_KEY" method="POST">
<input type="email" name="email" required placeholder="you@example.com" />
<button type="submit">Join the waitlist</button>
</form>
One requirement: add your site's domain to the waitlist's whitelisted domains (waitlist → Settings), or submissions are rejected. On submit, the subscriber is redirected to their hosted thank-you page with their position and referral link. Form action endpoint details →
Option D — the API or SDK (Growth plan+)
For custom signup flows, use the REST API — or the official SDK:
npm install waitlister
import { Waitlister } from 'waitlister'
const wl = new Waitlister({ apiKey: 'YOUR_API_KEY', waitlistKey: 'YOUR_WAITLIST_KEY' })
const result = await wl.signUp({ email: 'user@example.com' })
// result.position, result.referral_code, result.redirect_url
Your API key lives in the waitlist's Settings page. Machine-readable spec: openapi.json · Authentication →
3. Verify it works
Sign up with a real email address (Waitlister validates deliverability, so test addresses like test@example.com are rejected). You should land on the thank-you page with a queue position — and the subscriber appears in your dashboard.
Next steps
- Welcome emails — greet every signup automatically
- Referral program — let subscribers climb the queue by sharing
- Analytics — track views, conversion, and referral sources
- Webhooks — get notified of signups in your own systems
