Merging customers

The merge customer feature enables you to merge duplicate customer records in ChartMogul into one record. You can merge customers individually in ChartMogul or in bulk using the Merge Customer endpoint as part of our Import API.

A common use case for merging customer records would be a customer existing in two different billing systems. This would result in a duplicate record of this customer when importing the data from both billing systems into ChartMogul. The customer merge feature allows you to consolidate the corresponding customers and their billing history.

The following happens when merging customer records:

  • The merged customer will have the UUID, email address, and location of the customer that they are being merged into.
  • Both customers’ external IDs, tags, custom attributes, and notes will be preserved.
  • Subscriptions, MRR movements, and transactions will be collated and ordered by date.
  • If the same custom field exists on the customer record that you are merging into, the field value of the target customer will be preserved, and the one from the source customer will be lost.
Merging customers is permanent and cannot be undone.

Merging customers from the UI

Merging a small number of customer records in-app is generally manageable. Here's how:

    1. Navigate to the customer profile that you want to merge and click Merge.
    2. In the dialog that opens, click the field below Customer to merge into.
    3. We will automatically make a suggestion based on the email address or company name of the source customer that you can select. You can also search for the target customer manually by typing a search string into the box. 
    4. Once you have found the target customer to merge into, click on Next.
    5. You will be asked to confirm that this is the intended customer to merge into. Please click on Confirm and merge to proceed.

It may take a moment for the MRR movements table to rebuild. Once the process has been completed, you will see a notification at the right bottom saying, "Customers merged successfully."

Merging customers using the API

To merge a larger number of customer records, you can do so programmatically using our Merge Customers API endpoint. Learn more in our Developer Hub.


Was this article helpful?