Gamearly Connect#
To award XP and rewards correctly, Gamearly must know which of your users maps to which Gamearly user.
Your project should:
- Provide a "Link to Gamearly" button or screen.
- Call
POST /v1/link/startwith yourpartner_user_id— your own user's id. - Use one of the returned linking methods:
- redirect the player to the verification URL,
- show the QR code for linking from a phone,
- display the link and code for manual entry.
- Once the player completes the flow, the link is active.
Learning the result#
You can find out that a link completed in either of two ways:
- Handle the
user.linkedwebhook event that Gamearly sends when the link completes, or - poll
GET /v1/link/statusand then callGET /v1/users/info.
Linking is retroactive for events
Events you sent for a device_id, or for a partner_user_id that was not yet linked, are
attributed the moment the player links. Nothing collected before linking is lost — see
Identity resolution.