Skip to main content
Text can create separate identity records for one customer — this happens when someone contacts an organization from another browser, device, or channel. A customer_id identifies one customer record, not necessarily the complete customer.

Customer clusters

The Customer Data Platform associates identities that belong to the same customer. Together, they form a customer cluster:
One record becomes the master record for the cluster and represents its combined customer data. The other records remain child identities and retain their own customer_id values and source data. Merging identities does not replace their customer IDs with the master record’s ID. If customer record B is merged into master record A, its customer_id remains B, while cluster_id and monitoring.master_id contain A.

Customer IDs in API responses

Different APIs can return different IDs from the same cluster. For example, a chat can contain the customer record associated with that conversation, while a customer list can return the cluster’s master identity.

Retrieve customer data

Choose the method based on the data you need:
If an email address, phone number, chat, or ticket appears to be missing from one customer record, pass its customer_id to get_merged_customer before concluding that the data is unavailable.