Sign in

v1

latestOpenAPI 3.0.32026-07-26120117318.1 KB
Identities

Create an identity link

Links a Qonversion anonymous user to an external identity ID. If user_id is null, a new user is created and linked. This is the mechanism for matching Qonversion anonymous users with your own user IDs.

post/identities

Headers

Idempotency-Keystring

Idempotency key for safe retries. Same key returns the original response.

Request body

identity_idstring required

External identity ID to assign. Identities are append-only — posting the same identity_id twice returns 409.

user_idstring nullable

Qonversion user ID to bind. If null, a new anonymous user is created and linked.

Example request

{
  "identity_id": "ext-user-123",
  "user_id": "QON_3af4c5b8a4d24f21b72e9d0c8aef9d4e"
}

Response

Identity created successfully.

object'identity' required
idstring required

External identity identifier.

urlstring required

Canonical API path.

user_idstring required

Qonversion user identifier linked to this identity.

Example response

{
  "id": "ext-user-123",
  "url": "/v4/identities/ext-user-123",
  "user_id": "QON_3af4c5b8a4d24f21b72e9d0c8aef9d4e"
}