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: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:- Use
get_customerfor the data stored on one identity. - Use
get_merged_customerfor data combined across a cluster. You can pass any customer ID from the cluster and receive the same merged view. - Use
get_merged_customer_chatsorget_merged_customer_ticketsfor activity associated with every identity in the cluster.