API & Webhooks
Build your waitlist
into anything
REST API for subscriber management, real-time webhooks for event-driven workflows, plugins for 9 platforms, and a form action endpoint for zero-JS integration. Build custom signup flows, sync to your CRM, or run your entire waitlist headlessly.
POST /api/v1/waitlist/{key}/sign-up
X-Api-Key: wl_sk_...
{
"email": "[email protected]",
"name": "Sarah Chen"
}{
"success": true,
"position": 142,
"referral_code": "happy-star-4f3d",
"referral_link": "https://..."
}6,500+ founders build on Waitlister






























Your waitlist, your rules
The hosted landing page and embed widgets work for most founders. The API is for when you need full control.
Build a signup flow that matches your product
Design your own form, host it on your own domain, style it however you want. The API handles validation, position assignment, referral tracking, and welcome emails behind the scenes. Your users never see Waitlister.
Sync subscribers to your CRM in real time
Webhooks fire the instant someone signs up, completes a referral, or hits a points milestone. Pipe events to HubSpot, Salesforce, Slack, your database, or any tool with an HTTP endpoint — no polling, no batch exports.
Reward subscribers for anything
Award custom points via the API for actions Waitlister doesn't track natively — completing a survey, joining your Discord, sharing on Twitter, testing a beta build. The leaderboard updates automatically.
Keep fraud detection working on custom forms
Forward the end user's IP and device fingerprint in the API request to enable the full fraud detection pipeline — even on signups that come through your own backend. Without it, API signups skip fraud checks by default.
REST API endpoints
Base URL: https://waitlister.me/api/v1
| Method | Endpoint | Description |
|---|---|---|
| POST | /sign-up | Add a subscriber to your waitlist |
| GET | /subscribers | List subscribers with pagination |
| GET | /subscribers/{id} | Get subscriber by ID or email |
| PUT | /subscribers/{id} | Update subscriber (name, points, metadata) |
| POST | /log-view | Log a waitlist page view for analytics |
Real-time events for automation
Receive HTTP notifications whenever something happens on your waitlist. HMAC-signed for security, with automatic retries on failure.
waitlist.signup_created
Fires when someone joins your waitlist. Sync new subscribers to your CRM, trigger a Slack notification, update your analytics dashboard, or send a custom welcome email from your own system.
waitlist.referral_completed
Fires when a referral is successfully credited (fraud-blocked referrals don't trigger this). Reward top referrers, send thank-you messages, or track viral growth in your own systems.
waitlist.milestone_reached
Fires when a subscriber reaches a configurable points threshold. Unlock rewards, grant early access, send a congratulation email, or trigger a custom workflow.
Get started for free
Start building your waitlist with Waitlister and get the most out of your pre-launch campaign
Before choosing Waitlister, I compared several alternatives. Honestly, Waitlister stands far ahead. The product is more intuitive, faster to set up, and clearly built with real attention to detail.
API access by plan
- REST API access
- Webhooks
- 60 RPM (subscriber endpoints)
- 200 RPM (log view endpoint)
- Priority API access
- Webhooks
- 120 RPM (subscriber endpoints)
- 400 RPM (log view endpoint)
Free and Launch plans include the form action endpoint and plugin access but not the REST API or webhooks. Rate limit headers are included in every response.
API & webhooks — common questions
Waitlister provides a REST API with JSON request/response, API key auth, rate limit headers, and endpoints for adding, listing, getting, and updating subscribers — plus custom point assignment and analytics logging. On top of the REST API: real-time webhooks for 3 event types (signup, referral, milestone), HMAC signature verification, automatic retries, and a form action endpoint for zero-JS HTML form integration. Native plugins for 9 platforms (Framer, Webflow, WordPress, Shopify, and more). API access starts at $39/mo (Growth). The form action endpoint and plugins work on all plans.
Yes — two options: 1. REST API: build a fully custom form and call the API from your Next.js server or client 2. Form action endpoint: point a standard HTML form to our endpoint — no JS needed, works with server-side rendering and server actions Both support double opt-in, referral tracking, and custom fields. The form action endpoint is the simplest; the API gives you full control over the UX.
Yes. Include the referral code in metadata when adding a subscriber: { 'metadata': { 'referred_by': 'happy-star-4f3d' } } By default, API signups skip fraud detection (since the IP Waitlister sees is your server's). To enable it, forward the end user's real IP and/or device fingerprint in the metadata. When either is provided, the full fraud pipeline runs.
Three events, each toggleable independently: • waitlist.signup_created — new subscriber joins • waitlist.referral_completed — successful referral (fraud-blocked ones don't fire) • waitlist.milestone_reached — subscriber hits a configurable points threshold Payloads include subscriber data, metadata, position, points, and referral details. All webhooks are HMAC-signed for security and automatically retried on failure.
Yes. The form action endpoint lets you point any HTML form's action attribute to Waitlister's endpoint. No JavaScript needed. Standard form submissions redirect to the thank-you page; AJAX submissions return JSON. This works with any frontend: static HTML, server-rendered pages, no-code builders, email links. It supports custom fields and respects double opt-in settings.
Growth plan: 60 requests per minute for subscriber endpoints, 200 RPM for the log view endpoint. Business plan: 120 RPM for subscriber endpoints, 400 RPM for log view. Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) are included in every response. Implement exponential backoff on 429 errors. For enterprise needs, contact support for custom limits.
Yes — via webhooks. Set up a webhook for the waitlist.signup_created event and point it at your CRM's API (or a middleware like Zapier/Make). Every new subscriber triggers a real-time HTTP notification with all their data. You can also use the List Subscribers endpoint to batch-sync periodically, or the Get Subscriber endpoint to look up individual records on demand.
The REST API and webhooks require the Growth plan ($39/mo) or Business plan ($99/mo). Business doubles the rate limits and adds priority support. The form action endpoint and all platform plugins (Framer, Webflow, WordPress, Shopify, etc.) work on every plan, including Free.
Get started for free
Start collecting sign ups for your
product launch in minutes — no coding required.
