Create Waitlist Entry
Joins a free waitlist plan as the authenticated user. Requires waitlist_entry:create. Repeated joins return the existing pending entry, or an approved entry with a valid membership. Paid plans are rejected; no payment method is collected and no membership is granted.
Authorizations
An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.
Headers
A unique key that makes this request safe to retry. See Idempotent requests.
255"d9105228-4a08-46b1-8b91-42fed586d383"
Pins the request to a dated API version.
"2026-09-15"
Body
The free waitlist plan to join, prefixed plan_.
"plan_xxxxxxxxxxxxxx"
Answers to the plan's checkout questions. Every required question must be answered.
Custom key-value pairs to store on the signup. Max 50 keys, 100 chars per key, 500 chars per string value. Ignored when the request returns an existing signup.
Response
joined
The seller account, prefixed biz_.
"biz_xxxxxxxxxxxxxx"
Why the last approval attempt failed, or null when none has. plan_unavailable — the plan, product, or seller account was deleted. already_member — the user already has a membership on a one-per-user product. checkout_failed — checkout failed, usually a declined payment, and the signup was denied. unknown — another failure; retry. Cleared when approval is requeued.
plan_unavailable, already_member, checkout_failed, unknown, null "plan_unavailable"
The account the signup was submitted on behalf of, prefixed biz_, or null when the user signed up for themselves.
When this signup was submitted, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
The waitlist signup ID, prefixed entry_.
"entry_xxxxxxxxxxxxxx"
The membership created for this signup, prefixed mem_, or null when there is none. Check the membership's status to determine access.
Custom key-value metadata associated with this signup.
The plan this signup belongs to, prefixed plan_.
"plan_xxxxxxxxxxxxxx"
The product this signup belongs to, prefixed prod_, or null when the plan has no product.
"prod_xxxxxxxxxxxxxx"
The signup's current state. Approval runs asynchronously, so a signup stays pending until processing completes. approved alone does not prove an active membership; check membership_id.
pending, approved, denied, canceled "canceled"
When this signup last changed, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
The user who submitted this signup, prefixed user_.
"user_xxxxxxxxxxxxxx"

