---
title: "Create Account Invite"
method: POST
path: "/v1/account/invite"
---

# Create Account Invite

`POST /v1/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.

## Request body

- CreateInviteRequest

## Response `200`

Account invite response.

- CreateInviteResponse
  - `status` 'ok', required
  - `code` string, required — Referral or invite code
  - `referrals_available` integer, required — Remaining lifetime referrals for this invite code.
  - `cooldown_ms` integer, nullable, required — Milliseconds until referrals become available again. Null for lifetime caps because no windowed cooldown applies.

## Other responses

- `400` — Bad request — the request was malformed or failed validation (bad query parameters, unparseable body, invalid signature, or a domain pre-check). The `error` field is a human-readable validation detail.
- `401` — Unauthorized — missing or invalid `POLYMARKET-PROXY` / `POLYMARKET-SECRET` credentials. `error` is `unauthorized`.
- `429` — Too Many Requests. `error` distinguishes the limit that was hit: `ip_rate_limited` (per-IP token bucket), `action_rate_limited` (per-account action rate), or `open_orders_limit` (resting open-order cap).
- `500` — Internal server error. `error` is `internal_error`.

---

[API](https://skmtc.net/polymarket/apis/polymarket-perps-http-api.md) · [All operations](https://skmtc.net/polymarket/apis/polymarket-perps-http-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polymarket/polymarket-perps-http-api/revisions/76e4e47cf3aa/schema)