Waitlist API reference

Waitlist API · Public-Waitlist

post/v1/waitlists/{workspace_slug}/{waitlist_slug}/entries/confirm

Confirm a sign-up (double opt-in)

Post the `token` from the link in the confirmation email. The sign-up moves from `unconfirmed` to `pending` or `approved`, its referrer gets credit, `entry.created` (and `entry.approved`) fire and the welcome email goes out. Using the link again changes nothing (`already_confirmed: true`). The hosted confirmation page calls this when the visitor presses the button; call it yourself if you host that page. No API key.

Path parameters

workspace_slug*string

Slug of the workspace that owns the waitlist (a renamed workspace's old slug still resolves).

waitlist_slug*string

Slug of the waitlist within its workspace.

Request body

token*string

The `token` query parameter of the link in the confirmation email.

Example: "1d0b78280e1a407b8706aeb7ff619088.k2Jx0bq9sXJmD1oQyZ0n8w"

Response · 200 Confirmed (or already confirmed).

status*object

Where the sign-up stands. `pending`: waiting for approval; `approved`: in; `rejected`: not offered a place; `unconfirmed`: email not confirmed yet.

rank*integer

Place in line as the owner sees it: 1 + the confirmed sign-ups ahead, after referral boosts. Null while `unconfirmed`, after `rejected`, and for a test sign-up.

Example: 12

referral_code*string

Referral code of this sign-up.

Example: "464QTHE0"

referral_count*integer

Confirmed sign-ups that used this referral code.

Example: 3

confirmed_at*string · date-time

When the email address was confirmed; null when the waitlist does not ask, or not yet.

waitlist_name*string

Display name of the waitlist.

Example: "Early Access Program"

referral_link*string · uri

The share link: the waitlist's `signup_page_url` with `?ref=<referral_code>`. Null when the waitlist has no sign-up page set; share `referral_code` instead.

Example: "https://acme.com/early-access?ref=464QTHE0"

referral_boost*integer

Places each confirmed referral moves this entry up.

Example: 5

rewards*object

Progress towards the waitlist's referral rewards.

status_url*string · uri

This entry's status link (hosted, or the waitlist's own `status_page_url` with `?token=`). Treat it like a password: whoever has it sees this entry.

status_page_url*string · uri

The waitlist's own status page, when it has one; the hosted page redirects there.

already_confirmed*boolean

`true` when the link had already been used; nothing changed.

Example: false

Example

Request

POST https://api.waitlist.productcraft.co/v1/waitlists/{workspace_slug}/{waitlist_slug}/entries/confirm
Content-Type: application/json

{
  "token": "1d0b78280e1a407b8706aeb7ff619088.k2Jx0bq9sXJmD1oQyZ0n8w"
}

Response

{
  "status": {},
  "rank": 12,
  "referral_code": "464QTHE0",
  "referral_count": 3,
  "confirmed_at": "2026-01-01T00:00:00.000Z",
  "waitlist_name": "Early Access Program",
  "referral_link": "https://acme.com/early-access?ref=464QTHE0",
  "referral_boost": 5,
  "rewards": {},
  "status_url": "string",
  "status_page_url": "string",
  "already_confirmed": false
}