v1

latestOpenAPI 3.0.32026-07-26120117318.1 KB

Users

Create a user

Create a new Qonversion user. The server generates the QON_… user id and returns it in the response body and the Location header.

v3's POST /v3/users/{id} accepted a client-supplied id; v4 standardises on server-issued ids across every resource.

Pass an Idempotency-Key header to make retries safe — the same key returns the originally-created user instead of creating a duplicate.

post/users

Headers

Idempotency-Keystring

Client-generated key that makes retries safe.

Request body

environment'prod' | 'sandbox' required

Environment the user belongs to.

Example request

{
  "environment": "prod"
}

Response

User created

object'user' required

idstring required

Qonversion User ID. SDK-generated IDs are prefixed with QON_.

urlstring required

Canonical API path.

environment'prod' | 'sandbox' required

Environment the user belongs to.

identity_idstring nullable

External identity identifier, if set. Null when not linked to an identity.

created_atstring date-time required

Creation timestamp (ISO 8601 UTC).

Example response

{
  "id": "QON_3af4c5b8a4d24f21b72e9d0c8aef9d4e",
  "url": "/v4/users/QON_3af4c5b8a4d24f21b72e9d0c8aef9d4e",
  "environment": "prod",
  "identity_id": "awesome_user",
  "created_at": "2025-09-15T12:30:00Z"
}