capabilities.work

Identity Merge and Verify

A 3-step recipe with Amplitude. We can help you get access.

Recipe · 3 steps

Identity Merge and Verify

Set properties, alias an anonymous ID into a known user, and verify the merged profile.

  1. Set user properties on the known account through the Identify API without sending an event.
  2. Map the anonymous user_id to the global user so both identities are consolidated into a single profile.
  3. Read the merged user profile for the global user to confirm the consolidated properties and identity.
What you'll need to have ready
  • apiKey: The Amplitude project API key used for the Identify call.
  • basicAuth: Base64-encoded api_key:secret_key credentials for the User Mapping Basic auth.
  • apiKeyAuth: The deployment/API key used as the Profile API Authorization value (without the Api-Key prefix).
  • globalUserId: The primary user ID that the anonymous identity will be mapped to.
  • anonymousUserId: The anonymous user ID to map into the global user.
  • userProperties: A map of $set/$setOnce/$add operations to apply to the known user's properties.
For your developer

Arazzo workflow amplitude:merge-identities, 3 operations: identifyUser → mapUser → getUserProfile. Specs on APIs.io.