/v1/workspaces/{workspace_id}/waitlists/{waitlist_id}/entries/{entry_id}AuthApprove or reject an entry
Sets `status` to `approved` or `rejected`, sends the matching email when the workspace has it set up, and emits `entry.approved` / `entry.rejected`.
Path parameters
workspace_id*string · uuidId of the workspace.
waitlist_id*string · uuidId of the waitlist.
entry_id*string · uuidId of the entry.
Headers
Idempotency-KeystringIdempotency key (24 h). A retry with the same key and body returns the first response instead of acting twice.
Request body
status*objectTarget status. Approving sends the approved email, rejecting the rejected one (when set up), and each emits its webhook event.
Example: "approved"
Response · 200 Entry status updated.
id*string · uuidEntry id.
waitlist_id*string · uuidThe waitlist the entry is on.
workspace_id*string · uuidThe workspace that owns the waitlist.
email*string · emailNormalised (lower-cased) email.
name*stringName given at sign-up.
interest*stringFree-text product interest from the sign-up; null when not given.
referrer*stringHow they heard about it, from the sign-up; null when not given.
referral_code*stringThis entry's referral code. Others pass it as `referral_code` on sign-up to credit this entry.
referral_count*integerNumber of honoured referrals.
referred_by_entry_id*string · uuidThe entry whose referral code this sign-up used; null when none.
position*integerPlace in the queue, from 1. Test entries have negative positions (-1, -2…) so they never take a real place.
is_test*booleanMade with "Add test signup". Test entries use a mailbox-simulator address and are left out of counts, analytics, exports and webhooks unless asked.
Example: false
fraud_signals*arrayWhy the referral fraud checks held this entry (`held`); empty otherwise. Kept after release as a record.
status*object`unconfirmed` waits for its owner to confirm their email (waitlists with `email_confirmation`) and does not count yet; `pending` waits for approval; `approved` and `rejected` are decided.
confirmed_at*string · date-timeWhen the owner confirmed their email address; null when the waitlist does not ask for it, or not yet.
invited_at*string · date-timeWhen the entry was invited into an Auth app; null when not invited.
invited_to_app_slug*stringSlug of the Auth app the entry was invited into; null when not invited.
metadata*objectCustom field values and anything else stored with the sign-up (`variant_id` when it was attributed to a variant).
created_at*string · date-timeWhen the entry signed up.
updated_at*string · date-timeWhen the entry last changed.
Example
Request
PATCH https://api.waitlist.productcraft.co/v1/workspaces/{workspace_id}/waitlists/{waitlist_id}/entries/{entry_id}
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
{
"status": "approved"
}import { Waitlist } from "@productcraft/waitlist";
// Reads PRODUCTCRAFT_API_KEY from the environment
const waitlist = new Waitlist();
const entry = await waitlist.lists.entries.update("3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f", "3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f", { status: "approved" });waitlist.lists.entries.update(waitlistId, entryId, params, options?): Waitlist.Entry
Response
{
"id": "00000000-0000-0000-0000-000000000000",
"waitlist_id": "00000000-0000-0000-0000-000000000000",
"workspace_id": "00000000-0000-0000-0000-000000000000",
"email": "user@example.com",
"name": "string",
"interest": "string",
"referrer": "string",
"referral_code": "string",
"referral_count": 0,
"referred_by_entry_id": "00000000-0000-0000-0000-000000000000",
"position": 0,
"is_test": false,
"fraud_signals": [
{
"code": "referrer_same_device",
"detail": "Signed up from the same device as the referrer."
}
],
"status": {},
"confirmed_at": "2026-01-01T00:00:00.000Z",
"invited_at": "2026-01-01T00:00:00.000Z",
"invited_to_app_slug": "string",
"metadata": {},
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}