Sign in
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.

messagestring

A note from the partner, shown as a quote in the invite email and signed with their name. Requires as_partner; sending it on an ordinary transfer is a 400. Omit it and the email sends without a note.

Example request

{
  "as_partner": true,
  "identifier": "marcus@shinetime.example",
  "message": "Hey — set this up after our call on Tuesday. Ping me anytime."
}

Response

Ownership transferred.

successboolean required

Example response

{
  "success": true
}

Changes

Changed in 1 of the 46 revisions of this API.1

Of the 46 revisions, 1 has no diff computed.