Skip to main content
POST
Submit a Suspension Appeal

Authorizations

Authorization
string
header
required

An Account API key. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Scopes

company:suspend_child

Headers

Idempotency-Key
string

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

Maximum string length: 255
Example:

"d9105228-4a08-46b1-8b91-42fed586d383"

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-11-17-3"

Body

application/json
suspension_appeal_submission
object
required
account_id
string | null

Direct subaccount ID, prefixed biz_. Required for platform API keys. Whop sessions may omit it for a personal appeal.

Example:

"biz_xxxxxxxxxxxxxx"

Response

appeal submitted

accounts
object[]
required
created_at
string
required

When the appeal was signed and submitted, as an ISO 8601 timestamp.

Example:

"2026-01-01T12:00:00.000Z"

decided_at
string | null
required

When the decision was recorded, as an ISO 8601 timestamp.

Example:

null

external_reason
string | null
required
deprecated

The same value as reviewer_note. DEPRECATED: Use reviewer_note instead.

Example:

null

id
string
required

The appeal ID, prefixed inrq_.

Example:

"inrq_xxxxxxxxxxxxxx"

review_due_at
string
required

When Trust & Safety commits to a decision by, as an ISO 8601 timestamp.

Example:

"2026-01-01T12:00:00.000Z"

reviewer_note
string | null
required

The note the reviewer wrote to the appellant about the decision. null until the appeal is decided, when the reviewer wrote none, or when the appeal covers accounts the viewer can't see.

Example:

null

status
enum<string>
required

The review outcome.

Available options:
pending,
approved,
denied
Example:

"pending"

subject_id
string
required

The suspended personal account (user_) or business (biz_) this appeal covers.

Example:

"biz_xxxxxxxxxxxxxx"