---
title: "Create a user"
method: POST
path: "/users"
tags: ["Users"]
---

# Create a user

`POST /users`

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.

## Headers

- `Idempotency-Key` string

## Request body

- V4UserCreate
  - `environment` 'prod' | 'sandbox', required — Environment the user belongs to.

## Response `201`

User created

- V4User
  - `object` 'user', required
  - `id` string, required — Qonversion User ID. SDK-generated IDs are prefixed with `QON_`.
  - `url` string, required — Canonical API path.
  - `environment` 'prod' | 'sandbox', required — Environment the user belongs to.
  - `identity_id` string, nullable — External identity identifier, if set. Null when not linked to an identity.
  - `created_at` string, date-time, required — Creation timestamp (ISO 8601 UTC).

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `415` — Unsupported Content-Type
- `500` — Internal error

---

[API](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4.md) · [All operations](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qonversion/qonversion-rest-api-v4/revisions/e3f72cf8951c/schema)