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). Up to 255 characters, alphanumeric + ., _, -.
  • Qonversion User ID — The QON_… ID the identity is attached to.
  • Append-only — Identities cannot be re-bound via this API. POSTing the same identity_id twice (even with a different user_id) returns 409 Identity already exists.
  • 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.