Create a Customer

POST {{baseUrl}}/customers

Creates a new customer in the CRM system. You can optionally provide:

• Basic contact details (first name, last name, phone, email)

• UTM metadata for tracking campaigns

• Customer status (for segmentation or automation)

• Assigned user ID (CRM operator)

• Custom address information

• Additional custom properties

Note: All fields are optional. If omitted, system defaults will be used where applicable. You can send null instead of some field to use system default settings.

Headers:

X-Api-Key: secret_api_key 
Content-Type: application/json

Behavior

• A successful response returns the full customer model, including the generated customer ID.

• You can use the returned id for subsequent actions, such as attaching customer events.

Refer to the Reference section for sample request and response bodies.