Create Platform User By Id
POST/users/v1/platform-user
Create a new platform user from a platform identity.
WARNING: This endpoint does not validate that the provided user ID is valid, and should only be used after validating a user's identity.
Required Permissions:
- For any player (including themselves) any of:
user:*,user:platform:create
Request
- application/json
Body
required
Possible values: [Anon, Basic, XboxLive, PSN, NintendoNAID, NintendoSwitch, NintendoPPID, Google, GooglePlay, Apple, Epic, Steam, Amazon, Twitch, RallyHere, LegacyName]
An enumeration.
Possible values: non-empty and <= 2048 characters
Platform user ID to create with
Possible values: <= 256 characters
Display name used when creating a new player
Responses
- 201
- 403
- 409
- 422
Platform user was created successfully
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [Anon, Basic, XboxLive, PSN, NintendoNAID, NintendoSwitch, NintendoPPID, Google, GooglePlay, Apple, Epic, Steam, Amazon, Twitch, RallyHere, LegacyName]
An enumeration.
Possible values: <= 2048 characters
Platform user ID to search/create with
Platform Display name
Player ID DEPRECATED use player_uuid instead
Player UUID
Person ID
DEPRECATED use active_player_uuid instead. Active player ID, if the player has an active player.
Active player UUID, if the player has an active player.
{
"platform": "Anon",
"platform_user_id": "string",
"display_name": "string",
"player_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"person_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"active_player_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
Error Codes:
-
auth_invalid_key_id- Invalid Authorization - Invalid Key ID in Access Token -
auth_invalid_version- Invalid Authorization - version -
auth_malformed_access- Invalid Authorization - malformed access token -
auth_not_jwt- Invalid Authorization -
auth_token_expired- Token is expired -
auth_token_format- Invalid Authorization - {} -
auth_token_invalid_claim- Token contained invalid claim value: {} -
auth_token_invalid_type- Invalid Authorization - Invalid Token Type -
auth_token_sig_invalid- Token Signature is invalid -
auth_token_unknown- Failed to parse token -
insufficient_permissions- Insufficient Permissions
- application/json
- Schema
- Example (from schema)
Schema
Default value: true
{
"auth_success": true,
"error_code": "string",
"desc": "string"
}
Failed to create platform user. See error code and description for further details.
Error Codes:
-
user_already_exists- User already exists
- application/json
- Schema
- Example (from schema)
Schema
Default value: true
{
"auth_success": true,
"error_code": "string",
"desc": "string"
}
Validation Error
- application/json
- Schema
- Example (from schema)
Schema
Array [
Array [
- MOD1
- MOD2
]
]
detail
object[]
loc
object[]
required
anyOf
string
integer
{
"detail": [
{
"loc": [
"string",
0
],
"msg": "string",
"type": "string"
}
]
}