v1

latestOpenAPI 3.0.32026-07-26120117318.1 KB
Customers

Set customer 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.

post/customers/{customer_id}/properties

Path parameters

customer_idstring required

Customer identifier.

Request body

Example request

{
  "properties": [
    {
      "key": "plan_tier",
      "value": "premium"
    }
  ]
}

Response

Properties set successfully. Returns updated customer data.

object required

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.