Skip to content
RallyHere Docs

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

Authorizations

Request Body required

Request parameters to create a user exists

object
platform
required

Platform to create with

string
Allowed values: Anon Basic XboxLive PSN NintendoNAID NintendoSwitch NintendoPPID Google GooglePlay Apple Epic Steam Amazon Twitch RallyHere LegacyName
platform_user_id
required

Platform user ID to create with

string
>= 1 characters <= 2048 characters
display_name

Display name used when creating a new player

string
<= 256 characters

Responses

201

Platform user was created successfully

Response for successfully creating a platform user

object
platform
required

Platform to search/create with

string
Allowed values: Anon Basic XboxLive PSN NintendoNAID NintendoSwitch NintendoPPID Google GooglePlay Apple Epic Steam Amazon Twitch RallyHere LegacyName
platform_user_id
required

Platform user ID to search/create with

string
<= 2048 characters
display_name

Platform Display name

string
player_id
required

Player ID DEPRECATED use player_uuid instead

integer
player_uuid
required

Player UUID

string format: uuid
person_id
required

Person ID

string format: uuid
active_player_id

DEPRECATED use active_player_uuid instead. Active player ID, if the player has an active player.

integer
active_player_uuid

Active player UUID, if the player has an active player.

string format: uuid

403

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_sig_invalid - Token Signature is invalid
  • auth_token_unknown - Failed to parse token
  • insufficient_permissions - Insufficient Permissions
object
auth_success
boolean
default: true
error_code
required
string
desc
required
string

409

Failed to create platform user. See error code and description for further details.

Error Codes:

  • user_already_exists - User already exists
object
auth_success
boolean
default: true
error_code
required
string
desc
required
string

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string