/v1/workspaces/{workspace_id}/waitlists/{waitlist_id}/test-entriesAuthAdd a test signup
Creates an entry marked `is_test` with a generated Amazon SES mailbox-simulator address (`success+test-…@simulator.amazonses.com`). Works on draft and paused waitlists and ignores `max_entries`. The entry shows in the entries list, takes a negative position, and is left out of counts, analytics, exports and webhooks unless asked. No email is sent unless `send_welcome_email` is true. Delete it like any other entry.
Path parameters
workspace_id*string · uuidId of the workspace.
waitlist_id*string · uuidId of the waitlist.
Headers
Idempotency-KeystringIdempotency key (24 h). A retry with the same key returns the first test entry instead of adding a second one.
Request body
namestringName on the test entry. Defaults to "Test signup".
Example: "Test signup"
trigger_webhooksbooleanSend `entry.created` (and `entry.approved` when the waitlist auto-approves) to your webhook endpoints for this entry. The payload carries `is_test: true`. Default `false`.
Example: false
send_welcome_emailbooleanSend the welcome email for this entry. It goes to the entry's mailbox-simulator address, which accepts it without delivering to a real inbox. Default `false`.
Example: false
Response · 201 Test entry created.
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
status*object`pending` waits for approval; `approved` and `rejected` are decided.
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
POST https://api.waitlist.productcraft.co/v1/workspaces/{workspace_id}/waitlists/{waitlist_id}/test-entries
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
{
"name": "Test signup",
"trigger_webhooks": false,
"send_welcome_email": false
}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,
"status": {},
"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"
}