Skip to main content
POST
/
users
/
{user_id}
/
properties
curl --request POST \ --url https://api.qonversion.io/v4/users/{user_id}/properties \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "properties": [ { "key": "color", "value": "blue" }, { "key": "invalid key", "value": "oops" } ] } '
{ "object": "user_properties_set_result", "url": "/v4/users/QON_3af4c5b8a4d24f21b72e9d0c8aef9d4e/properties", "saved_properties": [ { "object": "user_property", "key": "color", "value": "blue" } ], "property_errors": [ { "key": "invalid key", "error": "property key: invalid key. Error: invalid key format" } ] }

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.

Authorizations

​
Authorization
string
header
required

Bearer authentication using the project Secret Key (prefixed with sk_, or test_sk_ for sandbox). All v4 public endpoints require the Secret Key — see Authentication. Never expose the Secret Key in client-side code.

Headers

​
Idempotency-Key
string

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

Path Parameters

​
user_id
string
required

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

Maximum string length: 256

Body

application/json
​
properties
object[]
required
Required array length: 1 - 100 elements

Response

Properties processed (check property_errors for per-key failures).

​
object
enum<string>
required
Available options:
user_properties_set_result
​
url
string
required
Example:

"/v4/users/QON_3af4c5b8a4d24f21b72e9d0c8aef9d4e/properties"

​
saved_properties
object[]
required
​
property_errors
object[]
required