Customers
The business records contacts belong to.
Scope: customers
A contact is a channel identity — this phone number on WhatsApp, this email address. A customer is the company or household those identities belong to. One customer owns many contacts; a conversation belongs to a contact, and through it to a customer.
List customers
Customers in the account, filtered and paginated.
Create a customer
Create a customer.
Search customers
Find customers by an exact identifier, or by free text.
Get a customer
One customer. Pass `include=contacts` to get its channel identities in the same call.
Update a customer
Only the fields you send change. Changing `lifecycle_stage` writes a journey event.
Delete a customer
Delete a customer.
List a customer's contacts
The channel identities linked to this customer — what you pass as `contact_id` when starting a conversation.