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. 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. Account API keys submit requests as their account owner, who must be enrolled, verified, and not suspended.
Authorizations
An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.
Headers
A unique key that makes this request safe to retry. See Idempotent requests.
255"d9105228-4a08-46b1-8b91-42fed586d383"
Pins the request to a dated API version.
"2026-09-15"
Body
Response
Existing pending request returned.
Business receiving the request, when one is assigned.
Unique referral code, when assigned.
When the request was created, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
Partner referral request ID, prefixed prfr_.
"prfr_xxxxxxxxxxxxxx"
Maximum permitted redemptions, when limited.
Public profile of the requesting partner.
How the referral request was initiated.
manual, ownership_transfer, reward_link "manual"
The approval state, or null for requests without an approval process.
pending, accepted, denied, cancelled, null "accepted"
When the request last changed, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"

