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.Documentation Index
Fetch the complete documentation index at: https://documentation.qonversion.io/llms.txt
Use this file to discover all available pages before exploring further.
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_idtwice (even with a differentuser_id) returns409 Identity already exists. - Create shape — v3 used
POST /identities/{identity_id}; v4 replaces this withPOST /identitieswhere the identity ID is sent in the body for cleaner REST semantics.
Available endpoints
| Method | Endpoint | Description | Status |
|---|---|---|---|
| POST | /identities | Create an identity link | New |
| GET | /identities/{identity_id} | Get an identity by external ID | Updated — v3 |