Skip to main content

Create custom partner code

POST 
/v1/partnership/partner/codes

Create a unique custom partner code that can be included in a partner link used for client acquisition, optionally bound to a partner account. The response returns the created partner link with that custom partner code.

Required scopes:

  • write: partnership.all.

Runtime restrictions:

  • The partner must be permitted to create partner codes.

Rules:

  • A partner can have up to 20 active custom partner codes.
  • partner_code must contain 3 to 10 lowercase Latin letters, digits, underscores, or hyphens. A numeric-only code and a code beginning with c_ are not allowed.
  • The code must be unique and must not contain terms prohibited by the service, including explicit language or Exness-related terms.

Rate limits:

  • This operation counts toward the shared limit of 600 requests per 60 seconds per partner, across all of the partner's API keys and all Partnership API operations.

Consistency and recovery notes:

  • The current Partnership API does not provide idempotent-write semantics. After a timeout or connection failure, read the affected resource or list before deciding whether to retry.

Possible errors:

  • Throttled
  • ServiceTransportError
  • Error
  • AuthenticationFailed
  • PermissionDenied
  • ValidationError

Request​

Responses​

Successful response.