The API call is used to create or update a player in Gameball with the provided attributes.
This endpoint could also be used in case of referral. In such case,referralCode of the referring player is to be provided along with the body parameters. So that Gameball understands that the newly created player is being referred.
Client API key
Unique identifier for the player in your database.
Could be database ID, random string, email or anything that uniquely identifies the player.
An objectwith set of properties that you want to set for the player.
Referring player’s referral code. This is used in case of referral, where the player to be created is referred by the player having this code.
The level order to place the player in.
IMPORTANT: manual player leveling is available under special circumstances and is not available by default. Contact us for more info.
Player's display name
Player's first name
Player's last name
Player's gender. Example: M or F, Male or Female.
Player's date of birth
Player join date at your system.
Comma separated string of tags to be attached to the player.
This example is a request sent to Gameball when player with referralCode“CODE11” successfully refers a new player with playerUniqueId“player456”. Player attributes are also sent within the same request.
Note: All attributes inside the playerAttributes object are optional, if the values of any attributes shown below are unavailable, remove the attribute from the playerAttributes object.