Skip to main content
An Identity binds a Qonversion User ID to your own external user ID (e.g., your auth system’s primary key). This enables consistent user tracking across devices and platforms. Identities are the preferred way to reconcile anonymous SDK users with authenticated users after login.

​
Key concepts

  • Identity ID — The external ID you control (e.g., user_42).
  • Qonversion User ID — The QON_… ID the identity is attached to.
  • Re-linking — POSTing the same identity with a different user ID re-binds the identity.
  • Create shape — v3 used POST /identities/{identity_id}; v4 replaces this with POST /identities where the identity ID is sent in the body for cleaner REST semantics.

​
Available endpoints

MethodEndpointDescriptionStatus
POST/identitiesCreate an identity linkNew
GET/identities/{identity_id}Get an identity by external IDUpdated — v3

​
Authentication

All v4 endpoints require a Secret Key. See Authentication.