post

/users/linking_info

Gets the user’s IDs by social ID and platform. The method will return:

  • user ID if the user has linked the main account.
  • user ID if the user has linked the platform account.
  • xl_uid=null if the user does not have the linked account.

Main account is the Xsolla Login project which other Xsolla Login projects (platform accounts) are linked to. Main and platform accounts are created in Publisher Account.

Method available with the server JWT in the X-SERVER-AUTHORIZATION header only. To get the server token, use the Generate User JWT method with grant_type=client_credentials.

Authorization

apiKey - X-SERVER-AUTHORIZATION

Request Body

Schema
object

List of social IDs and platforms which need user ID.

project_id
string

Login ID from Publisher Account.

2 validations
publisher_project_id
integer

Project ID from Publisher Account which you make a request for.

If you specify it, but do not specify project_id parameter, service will be found linked to its project_id. Contact your Account Manager to link project_id to publisher_project_id.

1 validation
users
array[object]

Social ID and platform for which it is needed to get user ID.

1 validation + required

Responses

OK

Schema
array[object]
email
string

User email.

1 validation
external_account_id
string

User ID from your game. Used as an external ID by which users will be linked.

1 validation
platform
string

Name of chosen Social Provider.

1 validation + required
user_id
string

User ID from Social Provider.

1 validation + required
xl_uid
string

The Xsolla Login user ID. You can find it in Publisher Account > Login settings > Users > Username/ID.

1 validation + required

Send a Test Request

Send requests directly from the browser (CORS must be enabled)
$$.env
1 variable not set
X-SERVER-AUTHORIZATION