Create an account link

post

https://account-links.cortextech.io/v2/admin/clients/{clientId}/account-links

Creates a single account link under the specified clientId. The target authId must exist under that client.

The request fails if a primary link already exists for the same sourceSystemId when secondary=false.

Requires a JWT Bearer token with the ACCOUNTLINKSADMINCREATE role.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

clientId

string

required

The client identifier.

Body Params

Request body used for v2 administrative account link create and update operations.

authId

int64

required

The FanScore auth user ID to link.

sourceSystemId

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.

sourceSystemUserId

string

required

The user's identifier in the external system.

sourceSystemCreatedAt

date-time | null

Timestamp when the account was created in the external system. Optional. May be null.

alias

string | null

Optional human-readable alias for the link.

secondary

boolean

Defaults to false

Whether this link should be treated as a secondary link. A fan may have multiple secondary links for the same source system, but only one primary.

Headers

X-Real-IP

string

Optional. Recorded against the audit log entry for the change.

X-Forwarded-For

string

Optional. Recorded against the audit log entry for the change.

Responses

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The newly created account link.

400Validation error, or account_link_exists if an identical link already exists, or auth_id_already_linked if the authId is already linked as a primary.

401Missing or invalid credentials.

403Forbidden - caller does not have the ACCOUNTLINKSADMINCREATE role.

404The referenced user does not exist under the specified client.

500Internal Server Error.