API & Webhooks

Build your waitlist
into anything

REST API for sign-ups, subscribers and landing pages, real-time webhooks for event-driven workflows, and official apps for Framer, Webflow, WordPress and Wix. 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_acct_...

{
  "email": "user@example.com",
  "name": "Sarah Chen"
}
{
  "success": true,
  "position": 142,
  "referral_code": "happy-star-4f3d"
}

10,000+ founders build on Waitlister

Little Tusk
stagewise
graph.
Incredible
PandaOS
Gravity
STACKED LABS
PagePal
ChatAce.io
Instanote
Pop Date
Data Hokage
WalletX
Fink Academy
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, tags)
DELETE/subscribers/{id}Delete subscriber by ID or email
GET/tagsList subscriber tags with counts
GET/statsRead subscriber and view totals
POST/waitlistsCreate a waitlist
POST/landing-pageCreate your hosted landing page
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.

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.

waitlist.subscriber_unsubscribed

Fires when a subscriber unsubscribes from your waitlist. Update your CRM, remove them from email sequences, or track churn.

waitlist.subscriber_pending_expired

Fires when a subscriber doesn't confirm their double opt-in email in time. Send a re-engagement email, add them to a remarketing list, or track opt-in conversion.

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

Every plan, Free included
$0
  • Account API keys
  • Create waitlists, add sign-ups
  • Read stats
  • Manage landing pages
Growth
$49/mo
  • Subscriber data endpoints
  • Webhooks
  • 60 RPM (subscriber endpoints)
  • 200 RPM (log view endpoint)
Business
$129/mo
  • Subscriber data endpoints
  • Webhooks
  • 120 RPM (subscriber endpoints)
  • 400 RPM (log view endpoint)

Every plan can use account API keys. Subscriber data endpoints, per-waitlist API keys and webhooks start on Growth. Rate limit headers are included in every response.

FAQ

API & webhooks — common questions

Still have a question? Read the docs

Waitlister provides a REST API with JSON request/response, API key auth, rate limit headers, and endpoints for adding, listing, getting, updating, and deleting subscribers, creating waitlists, reading stats, and managing landing pages — plus custom point assignment and analytics logging.

On top of the REST API: real-time webhooks for 5 event types (signup, referral, milestone, unsubscribe, expired confirmation) with HMAC signature verification. Official apps for Framer, Webflow, WordPress, and Wix.

Account API keys work on every plan, including Free, for creating waitlists, adding sign-ups, reading stats and managing landing pages. Subscriber data endpoints and webhooks require Growth ($49/mo) or Business. The official apps work on all plans.

Yes — two options: 1. REST API: build a fully custom form and call the API from your Next.js server, so your API key stays out of the browser 2. Embed code: paste the Waitlister form into any page Both support double opt-in, referral tracking, and custom fields. The embed 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.

Five 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 • waitlist.subscriber_unsubscribed — subscriber unsubscribes • waitlist.subscriber_pending_expired — double opt-in confirmation expires Payloads include subscriber data, metadata, position, points, and referral details. All webhooks are HMAC-signed for security.

Free, Launch and Pro plans: 10 requests per minute for sign-ups and stats. Growth plan: 60 RPM for subscriber endpoints (300 RPM to list subscribers), 200 RPM for the log view and stats endpoints. Business plan: 120 RPM for subscriber endpoints (600 RPM to list subscribers), 400 RPM for log view and stats. 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.

Account API keys work on every plan, including Free, for creating waitlists, adding sign-ups, reading stats and managing landing pages. Subscriber data endpoints (list, get, update, delete) and webhooks require the Growth plan ($49/mo) or Business plan ($129/mo). Business doubles most rate limits. The official apps (Framer, Webflow, WordPress, Wix) work on every plan too.

Get started for free

Start collecting sign ups for your product launch in minutes — no coding required.

Create your waitlist