Create or get a customer
POST /customers is create or get. Call it whenever you are about to start a conversation for a user, without checking first whether they exist.
- A new customer returns
201withcreated: true. - A customer you already sent returns
200withcreated: false, unchanged.
externalId, or the same email, is the same customer.
Find a customer
Look up by your own id or by email:data array and not 404. To fetch by Cerium id use GET /customers/{customerId}.
Update a customer
PATCH /customers/{customerId} changes only what you send. Send at least one field.
Attributes are defined by name in your Cerium dashboard. Sending an attribute that does not exist is refused with
unknown_attribute. A request is checked in full before anything changes, so a refused request changes nothing.