Link user IDs via external ID

Link user IDs via external IDServer-side

post/users/account/link_external_id

Links a user from your game to a user from your Login project via an external ID. You will not be able to link the same external ID to different users and update the external ID of a user if they already have it.

You can find an external ID in:

a user JWT after successful authentication as a value of the external_account_id claim,
a response of the Get user details call as a value of the external_id parameter.

SecurityServer

Request

Request Body schema: application/json

external_account_id required	string [ 1 .. 255 ] characters User ID from your game. Used as an external ID by which users will be linked.
user_id required	string <uuid> The Xsolla Login user ID. You can find it in Publisher Account > your Login project > Users > Username/ID.

Responses

200

400

Bad Request

401

Unauthorized

404

Not Found

422

Unprocessable Entity

429

Too Many Requests

Request samples

application/json

{"external_account_id": "A1234BB23",
"user_id": "6bd371c2-8044-11e9-b0a8-39deff2bb627"
}

Response samples

{"error": {"code": "003-061",
"description": "Object not found.",
"details": { }
}
}