---
title: "Set customer properties"
method: POST
path: "/customers/{customer_id}/properties"
tags: ["Customers"]
---

# Set customer properties

`POST /customers/{customer_id}/properties`

Sets one or more custom properties on a customer.
Accepts up to 100 key/value pairs per request.
Keys must be 1–256 characters; values must be at most 1024 characters.

## Path parameters

- `customer_id` string, required

## Request body

- V4CustomerPropertiesRequest
  - `properties` object[], required — List of key/value property pairs to set on the customer. 1–100 items.
    - `key` string, required — Property key. 1–256 characters.
    - `value` string, required — Property value. At most 1024 characters.

## Response `200`

Properties set successfully. Returns updated customer data.

- object — 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.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Customer not found
- `415` — Unsupported Content-Type
- `429` — Too many requests
- `500` — Internal error
- `502` — Storage error
- `504` — Upstream timeout

---

[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/versions/e3f72cf8951c/schema)