Sign in
latestOpenAPI 3.1.02026-08-163864115.7 MB

c363cb2feb95

Accounts

Transfer Account Ownership

Transfers ownership of the account to another user, identified by user ID or email address. If the recipient already holds the owner role, ownership moves immediately; otherwise they get an invite and ownership moves when they accept.

post/accounts/{id}/transfer_ownership

Path parameters

idstring required

Account ID, prefixed biz_.

Headers

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

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

Request body

as_partnerboolean

If true, the current owner is credited as the account's Whop partner, earning partner commission on its sales. Requires the current owner to already be an enrolled Whop partner. Skipped if the account already has an active partner.

identifierstring required

The user to transfer ownership to: a user ID (user_*) or an email address. An email address with no Whop account yet is sent an invite to create one.

Example request

{
  "as_partner": true,
  "identifier": "marcus@shinetime.example"
}

Response

Ownership transferred.

successboolean required

Example response

{
  "success": true
}