Sign in
Partner Referral Requests

Create a partner referral request

Creates a pending manual request for an existing business as the authenticated, enrolled, verified Whop partner. Provide exactly one of account_id or account_url. Whop business and product links resolve to their business. A business owner must accept before attribution changes. An existing pending manual request from the same partner returns 200; a new request returns 201. Alternatively, send request_type=link without a code, business, or redemption limit to get your oldest saved referral link, or create one with a randomly generated code when none exists. Provide a custom code or redemption limit to create a new link; omitted codes are generated randomly. Only authorized staff may configure rewards or select another partner. Link creation requires partner enrollment and a non-suspended account, but not verification. Use a Whop login session or an account API key with partner:referral_request:create. The key must have been created by the account's current owner and acts as that owner.

post/partner_referral_requests

Headers

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

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

Request body

OR
OR

Example request

{
  "account_id": "biz_xxxxxxxxxxxxxx"
}

Response

Existing request or referral link returned.

codestring nullable required

Unique referral code, when assigned.

created_atstring required

When the request was created, as an ISO 8601 timestamp.

idstring required

Partner referral request ID, prefixed prfr_.

max_redemptionsinteger nullable required

Maximum permitted redemptions, when limited.

request_type'manual' | 'ownership_transfer' | 'link' required

How the referral request was initiated.

status'pending' | 'accepted' | 'denied' | 'cancelled' | 'null' nullable required

The approval state, or null for requests without an approval process.

updated_atstring required

When the request last changed, as an ISO 8601 timestamp.

Example response

{
  "account": {
    "id": "biz_xxxxxxxxxxxxxx",
    "title": "Shine Time Auto Detailing"
  },
  "created_at": "2026-01-01T12:00:00.000Z",
  "id": "prfr_xxxxxxxxxxxxxx",
  "partner": {
    "id": "user_xxxxxxxxxxxxxx",
    "name": "Dana Whitfield",
    "profile_picture": {
      "url": "https://ui-avatars.com/api/"
    },
    "username": "danawhitfield"
  },
  "request_type": "manual",
  "rewards": [
    {
      "bot_qualification_type": "sales",
      "qualification_amount": {
        "amount": "-2.50",
        "currency": "usd",
        "decimals": 2,
        "display_decimals": 2
      },
      "recipient": "business",
      "reward_amount": {
        "amount": "-2.50",
        "currency": "usd",
        "decimals": 2,
        "display_decimals": 2
      }
    }
  ],
  "status": "accepted",
  "updated_at": "2026-01-01T12:00:00.000Z"
}

Changes