Skip to main content
POST
/
customers
/
{customer_id}
/
properties
Set customer properties
curl --request POST \
  --url https://api.qonversion.io/v4/customers/{customer_id}/properties \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "properties": [
    {
      "key": "plan_tier",
      "value": "premium"
    }
  ]
}
'
{
  "object": "customer_properties",
  "url": "/v4/customers/customer_abc123/properties",
  "data": {
    "saved_properties": [
      {
        "key": "plan_tier",
        "value": "premium"
      },
      {
        "key": "referral_source",
        "value": "email_campaign"
      }
    ],
    "property_errors": []
  }
}

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.

Path Parameters

​
customer_id
string
required

Customer identifier.

Body

application/json
​
properties
object[]
required

List of key/value property pairs to set on the customer. 1–100 items.

Required array length: 1 - 100 elements

Response

Properties set successfully. Returns updated customer data.

Property-save result wrapped in the v4 envelope (object, url, data). data.saved_properties lists the (key, value) pairs that were accepted; data.property_errors lists any rejected pairs with the reason — both are always present, empty arrays on success.