Accounts

Transfer Account Ownership

Changed on

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. The Whop CLI and MCP can hand off a business their user owns as a partner (as_partner: true) with the partner:handoff scope; other OAuth apps cannot transfer ownership.

post/accounts/{id}/transfer_ownership

Request

  • Base URL: https://api.whop.com/api/v1
  • URL: https://api.whop.com/api/v1/accounts/{id}/transfer_ownership
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

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.

authorized_user_idstring

Your team membership on the business this referral is made for, prefixed ausr_. The referral then credits that team instead of you personally. Requires as_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,
  "authorized_user_id": "ausr_xxxxxxxxxxxxxx",
  "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

  • 74b0de8090d9Revision changes
    • info

      the security scope company:transfer_ownership was added to the endpoint's security scheme bearerAuth

    • info

      the security scope partner:handoff was removed from the endpoint's security scheme bearerAuth

  • 305242fb9babRevision changes
    • info

      the security scope company:transfer_ownership was added to the endpoint's security scheme bearerAuth

    • info

      the security scope partner:handoff was removed from the endpoint's security scheme bearerAuth