Skip to main content
POST
/
users
/
{user_id}
/
properties
Set (upsert) properties for a user
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"
    }
  ]
}
'
{
  "object": "user_properties_set_result",
  "url": "/v4/users/user_abc123/properties",
  "saved_properties": [
    {
      "object": "user_property",
      "key": "color",
      "value": "blue"
    }
  ],
  "property_errors": [
    {
      "key": "bad_key",
      "error": "invalid key"
    }
  ]
}

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

The user identifier.

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/user_abc123/properties"

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