API Reference

Create an account link (v2)

post
https://account-links.cortextech.io/v2/admin/clients//account-links

Creates a single account link for the specified clientId. The target authId must exist under that client. Fails if a primary link already exists for the same sourceSystemId and secondary=false.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
Body Params

Request body for creating, updating, or deleting an account link. For delete only authId, sourceSystemId, and sourceSystemUserId are read; other fields are ignored.

int64
required

The Cortex auth user ID to link.

string
required

External system identifier (e.g. TICKETMASTER, CRM_GUID). On v1 admin endpoints this field is ignored; the source system is derived from the X-APP-ID configuration.

string
required

The user's identifier in the external system.

date-time | null

When the account was created in the external system. Optional.

string | null

Optional human-readable alias for the link.

metadata
object | null

Optional free-form metadata. Use metadata.email to associate an email with the link.

boolean
Defaults to false

Mark this link as secondary (a fan may have multiple secondary links for the same source system, but only one primary).

Headers
Responses

400

Validation error, or one of:

  • account_link_exists if an identical link already exists.
  • auth_id_already_linked if the authId is already linked to the same source system as a primary and secondary=false.
401

Missing or invalid credentials.

403

Caller authenticated but lacks the required role.

404

The authId does not exist under the specified clientId.

500

Unexpected server error.

Updated about 1 month ago

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 month ago