/v1/waitlists/{workspace_slug}/{waitlist_slug}/entries/confirmConfirm 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*stringSlug of the workspace that owns the waitlist (a renamed workspace's old slug still resolves).
waitlist_slug*stringSlug of the waitlist within its workspace.
Request body
token*stringThe `token` query parameter of the link in the confirmation email.
Example: "1d0b78280e1a407b8706aeb7ff619088.k2Jx0bq9sXJmD1oQyZ0n8w"
Response · 200 Confirmed (or already confirmed).
status*objectWhere the sign-up stands. `pending`: waiting for approval; `approved`: in; `rejected`: not offered a place; `unconfirmed`: email not confirmed yet.
rank*integerPlace 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*stringReferral code of this sign-up.
Example: "464QTHE0"
referral_count*integerConfirmed sign-ups that used this referral code.
Example: 3
confirmed_at*string · date-timeWhen the email address was confirmed; null when the waitlist does not ask, or not yet.
waitlist_name*stringDisplay name of the waitlist.
Example: "Early Access Program"
referral_link*string · uriThe 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*integerPlaces each confirmed referral moves this entry up.
Example: 5
rewards*objectProgress towards the waitlist's referral rewards.
status_url*string · uriThis 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 · uriThe 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
}