Gamearly API v1
Dashboard

Core concepts / Gamearly Connect

Gamearly Connect#

To award XP and rewards correctly, Gamearly must know which of your users maps to which Gamearly user.

Your project should:

  1. Provide a "Link to Gamearly" button or screen.
  2. Call POST /v1/link/start with your partner_user_id — your own user's id.
  3. 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.
  4. 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:

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.