[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fquickstart":3},{"_path":4,"title":5,"description":6,"navigation":7,"image":12,"head":17,"body":36},"\u002Fdocs\u002Fquickstart","Quickstart · Waitlister Documentation","Get your waitlist collecting signups in about five minutes. Four ways to go live: hosted landing page, embedded form, any HTML form, or the API.",{"title":8,"group":9,"description":10,"order":11},"Quickstart","Getting started","Go from zero to collecting waitlist signups in about five minutes — hosted page, embed, plain HTML form, or API.",2,{"src":13,"width":14,"height":15,"alt":16},"https:\u002F\u002Ffirebasestorage.googleapis.com\u002Fv0\u002Fb\u002Fwaitinglist-app-c24fc.appspot.com\u002Fo\u002Fdocs-og-image.png?alt=media&token=85e60b24-c882-4f84-aa9e-ef85e1ae4bb5",400,300,"Waitlister Quickstart",{"meta":18,"og":31,"twitter":33},[19,22,25,28],{"name":20,"content":21},"keywords","waitlist quickstart, getting started waitlist, add waitlist to website, waitlist form html, waitlist api quickstart",{"name":23,"content":24},"robots","index, follow",{"name":26,"content":27},"author","Waitlister",{"name":29,"content":30},"copyright","© 2026 Waitlister",{"title":5,"description":6,"type":32,"image":13},"article",{"card":34,"title":16,"description":35,"image":13},"summary_large_image","Zero to collecting waitlist signups in about five minutes — hosted page, embed, HTML form, or API.",{"type":37,"children":38,"toc":380},"root",[39,52,58,63,106,113,154,160,167,188,194,205,211,216,229,247,253,266,277,288,307,313,326,332],{"type":40,"tag":41,"props":42,"children":43},"element","p",{},[44],{"type":40,"tag":45,"props":46,"children":49},"span",{"className":47},[48],"secondary-heading",[50],{"type":51,"value":9},"text",{"type":40,"tag":53,"props":54,"children":56},"h1",{"id":55},"quickstart",[57],{"type":51,"value":8},{"type":40,"tag":41,"props":59,"children":60},{},[61],{"type":51,"value":62},"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.",{"type":40,"tag":64,"props":65,"children":67},"callout",{"type":66},"note",[68],{"type":40,"tag":41,"props":69,"children":70},{},[71,77,79,88,90,97,99],{"type":40,"tag":72,"props":73,"children":74},"strong",{},[75],{"type":51,"value":76},"Everything on this page in one fetchable file:",{"type":51,"value":78}," the ",{"type":40,"tag":80,"props":81,"children":85},"a",{"href":82,"rel":83},"https:\u002F\u002Fwaitlister.me\u002Fskill.md",[84],"nofollow",[86],{"type":51,"value":87},"one-page integration guide",{"type":51,"value":89}," has copy-paste code for every path below (ideal for AI agents) · ",{"type":40,"tag":80,"props":91,"children":94},{"href":92,"rel":93},"https:\u002F\u002Fwaitlister.me\u002Fopenapi.json",[84],[95],{"type":51,"value":96},"OpenAPI spec",{"type":51,"value":98}," · SDK: ",{"type":40,"tag":100,"props":101,"children":103},"code",{"className":102},[],[104],{"type":51,"value":105},"npm install waitlister",{"type":40,"tag":107,"props":108,"children":110},"h2",{"id":109},"_1-create-your-waitlist",[111],{"type":51,"value":112},"1. Create your waitlist",{"type":40,"tag":114,"props":115,"children":116},"ol",{},[117,129,142],{"type":40,"tag":118,"props":119,"children":120},"li",{},[121,127],{"type":40,"tag":80,"props":122,"children":124},{"href":123},"\u002Fsign-up",[125],{"type":51,"value":126},"Create a free account",{"type":51,"value":128}," — no credit card needed.",{"type":40,"tag":118,"props":130,"children":131},{},[132,134,140],{"type":51,"value":133},"Create a waitlist (the setup wizard takes a minute — ",{"type":40,"tag":80,"props":135,"children":137},{"href":136},"\u002Fdocs\u002Fcreate-a-waitlist",[138],{"type":51,"value":139},"details here",{"type":51,"value":141},").",{"type":40,"tag":118,"props":143,"children":144},{},[145,147,152],{"type":51,"value":146},"Note your ",{"type":40,"tag":72,"props":148,"children":149},{},[150],{"type":51,"value":151},"waitlist key",{"type":51,"value":153},", shown at the top of the waitlist's Overview page. You'll need it for options C and D below.",{"type":40,"tag":107,"props":155,"children":157},{"id":156},"_2-pick-how-youll-collect-signups",[158],{"type":51,"value":159},"2. Pick how you'll collect signups",{"type":40,"tag":161,"props":162,"children":164},"h3",{"id":163},"option-a-hosted-landing-page-no-code-fastest",[165],{"type":51,"value":166},"Option A — hosted landing page (no code, fastest)",{"type":40,"tag":41,"props":168,"children":169},{},[170,172,178,180,186],{"type":51,"value":171},"Waitlister hosts a full landing page for you. Customize it in the ",{"type":40,"tag":80,"props":173,"children":175},{"href":174},"\u002Fdocs\u002Flanding-page",[176],{"type":51,"value":177},"drag-and-drop editor",{"type":51,"value":179}," (or generate one with the ",{"type":40,"tag":80,"props":181,"children":183},{"href":182},"\u002Fdocs\u002Fai-page-builder",[184],{"type":51,"value":185},"AI page builder",{"type":51,"value":187},"), hit publish, and share the URL. Done — you can stop reading here.",{"type":40,"tag":161,"props":189,"children":191},{"id":190},"option-b-embed-a-form-on-your-site",[192],{"type":51,"value":193},"Option B — embed a form on your site",{"type":40,"tag":41,"props":195,"children":196},{},[197,199],{"type":51,"value":198},"Add a Waitlister form to a page you already have with a copy-paste embed snippet. Works on any site that allows scripts. ",{"type":40,"tag":80,"props":200,"children":202},{"href":201},"\u002Fdocs\u002Fform",[203],{"type":51,"value":204},"Set up the embeddable form →",{"type":40,"tag":161,"props":206,"children":208},{"id":207},"option-c-point-any-html-form-at-waitlister",[209],{"type":51,"value":210},"Option C — point any HTML form at Waitlister",{"type":40,"tag":41,"props":212,"children":213},{},[214],{"type":51,"value":215},"Keep full control of your design: any form can submit straight to Waitlister. Perfect for Webflow, Framer, Wix, or hand-written HTML.",{"type":40,"tag":217,"props":218,"children":224},"pre",{"className":219,"code":221,"language":222,"meta":223},[220],"language-html","\u003Cform action=\"https:\u002F\u002Fwaitlister.me\u002Fs\u002FYOUR_WAITLIST_KEY\" method=\"POST\">\n  \u003Cinput type=\"email\" name=\"email\" required placeholder=\"you@example.com\" \u002F>\n  \u003Cbutton type=\"submit\">Join the waitlist\u003C\u002Fbutton>\n\u003C\u002Fform>\n","html","",[225],{"type":40,"tag":100,"props":226,"children":227},{"__ignoreMap":223},[228],{"type":51,"value":221},{"type":40,"tag":41,"props":230,"children":231},{},[232,234,239,241],{"type":51,"value":233},"One requirement: add your site's domain to the waitlist's ",{"type":40,"tag":72,"props":235,"children":236},{},[237],{"type":51,"value":238},"whitelisted domains",{"type":51,"value":240}," (waitlist → Settings), or submissions are rejected. On submit, the subscriber is redirected to their hosted thank-you page with their position and referral link. ",{"type":40,"tag":80,"props":242,"children":244},{"href":243},"\u002Fdocs\u002Fform-action-endpoint",[245],{"type":51,"value":246},"Form action endpoint details →",{"type":40,"tag":161,"props":248,"children":250},{"id":249},"option-d-the-api-or-sdk-growth-plan",[251],{"type":51,"value":252},"Option D — the API or SDK (Growth plan+)",{"type":40,"tag":41,"props":254,"children":255},{},[256,258,264],{"type":51,"value":257},"For custom signup flows, use the ",{"type":40,"tag":80,"props":259,"children":261},{"href":260},"\u002Fdocs\u002Fapi",[262],{"type":51,"value":263},"REST API",{"type":51,"value":265}," — or the official SDK:",{"type":40,"tag":217,"props":267,"children":272},{"className":268,"code":270,"language":271,"meta":223},[269],"language-bash","npm install waitlister\n","bash",[273],{"type":40,"tag":100,"props":274,"children":275},{"__ignoreMap":223},[276],{"type":51,"value":270},{"type":40,"tag":217,"props":278,"children":283},{"className":279,"code":281,"language":282,"meta":223},[280],"language-js","import { Waitlister } from 'waitlister'\n\nconst wl = new Waitlister({ apiKey: 'YOUR_API_KEY', waitlistKey: 'YOUR_WAITLIST_KEY' })\nconst result = await wl.signUp({ email: 'user@example.com' })\n\u002F\u002F result.position, result.referral_code, result.redirect_url\n","js",[284],{"type":40,"tag":100,"props":285,"children":286},{"__ignoreMap":223},[287],{"type":51,"value":281},{"type":40,"tag":41,"props":289,"children":290},{},[291,293,299,301],{"type":51,"value":292},"Your API key lives in the waitlist's Settings page. Machine-readable spec: ",{"type":40,"tag":80,"props":294,"children":296},{"href":92,"rel":295},[84],[297],{"type":51,"value":298},"openapi.json",{"type":51,"value":300}," · ",{"type":40,"tag":80,"props":302,"children":304},{"href":303},"\u002Fdocs\u002Fapi\u002Fauthentication",[305],{"type":51,"value":306},"Authentication →",{"type":40,"tag":107,"props":308,"children":310},{"id":309},"_3-verify-it-works",[311],{"type":51,"value":312},"3. Verify it works",{"type":40,"tag":41,"props":314,"children":315},{},[316,318,324],{"type":51,"value":317},"Sign up with a real email address (Waitlister validates deliverability, so test addresses like ",{"type":40,"tag":100,"props":319,"children":321},{"className":320},[],[322],{"type":51,"value":323},"test@example.com",{"type":51,"value":325}," are rejected). You should land on the thank-you page with a queue position — and the subscriber appears in your dashboard.",{"type":40,"tag":107,"props":327,"children":329},{"id":328},"next-steps",[330],{"type":51,"value":331},"Next steps",{"type":40,"tag":333,"props":334,"children":335},"ul",{},[336,347,358,369],{"type":40,"tag":118,"props":337,"children":338},{},[339,345],{"type":40,"tag":80,"props":340,"children":342},{"href":341},"\u002Fdocs\u002Fwelcome-emails",[343],{"type":51,"value":344},"Welcome emails",{"type":51,"value":346}," — greet every signup automatically",{"type":40,"tag":118,"props":348,"children":349},{},[350,356],{"type":40,"tag":80,"props":351,"children":353},{"href":352},"\u002Fdocs\u002Freferral-program",[354],{"type":51,"value":355},"Referral program",{"type":51,"value":357}," — let subscribers climb the queue by sharing",{"type":40,"tag":118,"props":359,"children":360},{},[361,367],{"type":40,"tag":80,"props":362,"children":364},{"href":363},"\u002Fdocs\u002Fanalytics",[365],{"type":51,"value":366},"Analytics",{"type":51,"value":368}," — track views, conversion, and referral sources",{"type":40,"tag":118,"props":370,"children":371},{},[372,378],{"type":40,"tag":80,"props":373,"children":375},{"href":374},"\u002Fdocs\u002Fwebhooks",[376],{"type":51,"value":377},"Webhooks",{"type":51,"value":379}," — get notified of signups in your own systems",{"title":223,"searchDepth":381,"depth":381,"links":382},3,[383,384,390,391],{"id":109,"depth":11,"text":112},{"id":156,"depth":11,"text":159,"children":385},[386,387,388,389],{"id":163,"depth":381,"text":166},{"id":190,"depth":381,"text":193},{"id":207,"depth":381,"text":210},{"id":249,"depth":381,"text":252},{"id":309,"depth":11,"text":312},{"id":328,"depth":11,"text":331}]