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.

API request
200 OK
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

Data Hokage logo
Data Hokage
Fink Academy logo
Fink Academy
stagewise logo
stagewise
Sirius AI logo
Sirius AI
BLADNA logo
BLADNA
PagePal logo
PagePal
ChatAce.io logo
ChatAce.io
Instanote logo
Instanote
DirectoryDeck logo
DirectoryDeck
landman® logo
landman®
datapro logo
datapro
NATRU logo
NATRU
Pop Date logo
Pop Date
Aspire logo
Aspire
WalletX logo
WalletX
quickblogs logo
quickblogs
Data Hokage logo
Data Hokage
Fink Academy logo
Fink Academy
stagewise logo
stagewise
Sirius AI logo
Sirius AI
BLADNA logo
BLADNA
PagePal logo
PagePal
ChatAce.io logo
ChatAce.io
Instanote logo
Instanote
DirectoryDeck logo
DirectoryDeck
landman® logo
landman®
datapro logo
datapro
NATRU logo
NATRU
Pop Date logo
Pop Date
Aspire logo
Aspire
WalletX logo
WalletX
quickblogs logo
quickblogs
Why use the API

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.

Endpoints

REST API endpoints

Base URL: https://waitlister.me/api/v1

MethodEndpointDescription
POST/sign-upAdd a subscriber to your waitlist
GET/subscribersList subscribers with pagination
GET/subscribers/{id}Get subscriber by ID or email
PUT/subscribers/{id}Update subscriber (name, points, metadata)
POST/log-viewLog a waitlist page view for analytics
Webhook events

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.
J
John
Verified purchaser, AppSumo
Plans & rate limits

API access by plan

Growth
$39/mo
  • REST API access
  • Webhooks
  • 60 RPM (subscriber endpoints)
  • 200 RPM (log view endpoint)
Business
$99/mo
  • 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.

FAQ

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.