Skip to main content
POST
Set customer properties

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.