Sync errors in Chargebee Salesforce integration due to duplication rules

Modified on: Tue, 10 Jan, 2023 at 7:33 PM

This article covers 

You can make use of this guide when you get sync errors due to duplication rules.




Sync errors that happen due to duplication rules in spite of marking the action as Allow instead of Block. Active Salesforce duplicate rules can conflict with Chargebee that inserts records into your Salesforce organization. When Chargebee integration inserts a new record into Salesforce, the Salesforce duplicate rules are run. If a duplicate is found, the record is not inserted into Salesforce. Most of the integrations that work with Salesforce(including Chargebee) which insert records into Salesforce contain their own built-in duplicate matching rules and should be excluded from the Salesforce built-in duplicate matching rules.


Best Practice


The best practice is to allocate a Salesforce license to integration and assign them to a profile specifically set up for the integration user(s). The profile of the user who had connected Chargebee and Salesforce in this case. This profile can then be excluded from firing the duplicate rules.


There are also some integrations(including Chargebee) whose processes(automations) use the user who set the process up as the creator for new records. These should be reviewed as well as they may also cause records not to be inserted into Salesforce. The fix is to make sure the processes are owned by a user that is excluded from the firing of the duplicate rules. 




In the example below, the matching rules have been configured to run only when the Current User is not equal to our two Chargebee related profiles. This will exclude them from the duplicate checking process. 


  1. What are duplicate rules in SF ?                                

    A duplicate rule defines what happens when a starts creating/updating a duplicate record. . Salesforce provides standard duplicate rules for business and person accounts, contacts, and leads. This can also be customized by the client.                      

  2. How to check duplicate rule setup and indicate the same to the merchant?
     Ask the merchant to navigate to Setup> Quick Find> search duplicate > click on Duplicate rules. Check with the merchant if these are active and if the alert text matches the error received when syncing the customer. 




Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.