Platform Integration
REST API
User Accounts
Update Identifiers

Creating / Updating account identifiers

  • [CLIENT_ID]: Unique identifier for the client application, provided by Playfull
  • [GAME_ID]: Unique identifier for the game sending the event, provided by Playfull
  • [GENERATED_SIGNATURE]: A signature that verifies the integrity of the request (see Signature Generation)
  • [USER_ID]: The game's own internal user identifier
POST /v2/custom-events
x-client-id: "[CLIENT_ID]",
x-timestamp: "1698306156387",
x-signature: "[GENERATED_SIGNATURE]",
Content-Type: "application/json"
 
{
  "gameId": "[GAME_ID]",
  "identifiers": [
    {
      "userId": "[USER_ID]",
      "discordId": "123456789",
      "email": "john@doe.com",
      "twitterId": "987654321",
      "walletAddress": "0xb794f5ea0ba39494ce839613fffba74279579268"
      },
  ]
}

A full list of supported identifiers:

  • userId (required): string - in-game user identifier
  • discordId: string - numeric Discord ID
  • twitterId: string - numeric Twitter ID
  • steamId: string - Steam ID
  • email: string - User Email
  • epicGamesId: string - Epic Games ID
  • telegramId: string - Telegram ID
  • walletAddress: string - a valid Ethereum address
  • playfullUserId: string - Playfull user identifier. Playfull will attach a pfid search params on redirect link optionally. Please contact our team for more details.