Sign in
Waitlist Entries

Approve Waitlist Entry

Queues approval of a pending signup. Requires plan:waitlist:manage on its seller account. Paid signups may charge their saved payment method. Returns the signup's current state; retrieve it to read status and approval_failure_reason after processing.

post/waitlist_entries/{id}/approve

Headers

Idempotency-Keystring
Example:d9105228-4a08-46b1-8b91-42fed586d383

A unique key that makes this request safe to retry. See Idempotent requests.

Response

current signup state

account_idstring required

The seller account, prefixed biz_.

approval_failure_reason'plan_unavailable' | 'already_member' | 'checkout_failed' | 'unknown' | 'null' nullable required

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.

buyer_account_idstring nullable required

The account the signup was submitted on behalf of, prefixed biz_, or null when the user signed up for themselves.

created_atstring required

When this signup was submitted, as an ISO 8601 timestamp.

idstring required

The waitlist signup ID, prefixed entry_.

membership_idstring nullable required

The membership created for this signup, prefixed mem_, or null when there is none. Check the membership's status to determine access.

metadataobject required

Custom key-value metadata associated with this signup.

plan_idstring required

The plan this signup belongs to, prefixed plan_.

product_idstring nullable required

The product this signup belongs to, prefixed prod_, or null when the plan has no product.

status'pending' | 'approved' | 'denied' | 'canceled' required

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.

updated_atstring required

When this signup last changed, as an ISO 8601 timestamp.

user_idstring required

The user who submitted this signup, prefixed user_.

Example response

{
  "account_id": "biz_xxxxxxxxxxxxxx",
  "approval_failure_reason": "plan_unavailable",
  "created_at": "2026-01-01T12:00:00.000Z",
  "id": "entry_xxxxxxxxxxxxxx",
  "metadata": {},
  "plan_id": "plan_xxxxxxxxxxxxxx",
  "product_id": "prod_xxxxxxxxxxxxxx",
  "status": "canceled",
  "updated_at": "2026-01-01T12:00:00.000Z",
  "user_id": "user_xxxxxxxxxxxxxx"
}

Changes