FAQ
Quick answers to common problems.
Can I use a secret key in the browser?
No. It can read every signup and delete data. The React provider refuses
gw_sk_ keys. Use a publishable key there.
Why does join fail from my server with my publishable key?
Publishable keys are checked by the browser's Origin header, which servers do
not send. Use a secret key in server code, or call join from the browser.
Why do I get 403 from the browser?
The page's origin is not in the project's allowed origins. Origins match exactly:
scheme, host and port, no wildcards, no trailing slash. Also check CORS is not
being blocked by a proxy in front of the API.
Why is a test signup abuse_blocked?
The domain has no mail server (example.com, test.com with no MX), is a
known disposable provider, or the captcha failed. The response never says
which; the project page in the dashboard lists blocked attempts by reason.
Does a duplicate email create a second signup?
No. Joins are idempotent by normalized address (a.b+x@gmail.com equals
ab@gmail.com). The repeat returns the original signup with 200.
Why is everyone pending?
Double opt-in is on and they have not clicked the link, or emails are not
leaving: check CRON_SECRET and the cron schedule, the Resend domain and the
daily cap (production checklist). Use the resend
route for a single signup.
I did not get the confirmation email locally.
Development uses EMAIL_PROVIDER=log: the email and its link are printed in
the server console.
Can I turn off double opt-in?
Yes: settings.double_opt_in: false. Signups are verified on join. Referral
rewards then rely on the join alone, so expect more fake referrals.
How does a referral move someone up?
Only when the referred person confirms their email. Each converted referral
moves the referrer up positions_per_referral places (default 1).
Does position change? Yes. It is the live rank: it improves when people ahead of you are erased or when you refer people.
Where is my data, and can I leave? In Postgres, in plain tables. Stream events with webhooks and export CSV or JSON at any time (data ownership).
Can I delete a person?
Yes: DELETE the signup with a secret key. Personal fields are nulled and the
signup becomes an anonymous tombstone (privacy). They can also
use the remove link in any email.
I hit plan_limit_reached.
The free plan allows 2 projects per account, 2 waitlists per project, and 1,000 live signups per waitlist. Existing
data and positions are unaffected. Erasing signups frees slots.
Webhook endpoint stopped receiving events. Five failed deliveries in a row disable it. Fix the receiver, re-enable it, and redeliver missed events or backfill with an export.
Which runtimes does the SDK support?
Anything with fetch: browsers, Node 18+, Bun, Deno, edge. No dependencies.
Where is the API reference?
openapi/getwait.v1.json, with prose in
api.md.