Create Account Invite

Create or return the authenticated account's primary invite code. The call is idempotent for accounts that already have a primary invite code.

post/v1/account/invite

Request

  • Base URL: https://api.perpetuals.polymarket.com
  • URL: https://api.perpetuals.polymarket.com/v1/account/invite
  • Auth: API key in header POLYMARKET-PROXY and API key in header POLYMARKET-SECRET

Request body

CreateInviteRequest required

Response

Account invite response.

status'ok' required
codestring required

Referral or invite code

referrals_availableinteger required

Remaining lifetime referrals for this invite code.

cooldown_msinteger nullable required

Milliseconds until referrals become available again. Null for lifetime caps because no windowed cooldown applies.

Example response

{
  "code": "ABC123"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.