Watch the Video
Overview
Integrating Salesforce with Apollo enables you to access and keep your data synchronized within both platforms.
Before you integrate Salesforce with Apollo though, there are several important details to remember that can help you streamline the setup process and reduce the risk of unnecessary errors when integrating Salesforce.
Understand Salesforce Pull Settings
Pull settings relate to how Apollo pulls data from your Salesforce instance. Apollo must always pull your leads, contacts, and accounts from Salesforce. This allows Apollo to remove any matches from the Apollo database. It also prevents your team from accidentally prospecting records in Apollo that already exist in Salesforce.
You cannot disable the automatic pull feature, but you can hide Salesforce leads, contacts, accounts, and opportunities from view in Apollo. For more information, follow the steps in the Configure Your Salesforce Pull Settings article.
When Apollo identifies a lead and a contact for the same person in your Salesforce instance, Apollo always pulls the contact, not the lead. This is the only form of deduplication that Apollo runs against your Salesforce instance.
Understand Salesforce Push Settings
Push settings relate to how Apollo pushes data from Apollo into your Salesforce instance. Unlike the pull settings, you can enable or disable Salesforce push settings.
You can choose whether to sync all your Apollo-sourced records with Salesforce. However, Apollo always syncs all Salesforce-sourced records with Apollo.
Avoid Duplicate Records
There are several key duplication rules to keep in mind before connecting Salesforce.
When you integrate Salesforce, Apollo mirrors the data in your Salesforce instance. If you have duplicate leads, contact, or accounts in Salesforce, these same duplicates reflect in Apollo too. To avoid duplicate records post-sync, clean and deduplicate your Salesforce instance before you integrate the 2 platforms.
If Apollo pulls a duplicate from Salesforce, Apollo displays a potential duplicate message on the contact or account's profile page to notify you. You can also identify the record creation source from the activity log.
When you manually create a duplicate record in Salesforce, Apollo automatically creates the same record. Likewise, if you enable the Salesforce push settings and create a duplicate record in Apollo, Salesforce creates the same record within your Salesforce instance.
Apollo does not automatically delete or merge the duplicates that you manually create. If you decide to delete or merge any of these records, you must do so manually.
Remove Duplicate Records
If duplicate records have already been synced from Salesforce to Apollo, you have 2 options for removing them:
- Delete: If you enable the appropriate settings in Apollo, you can delete duplicate records in either Apollo or Salesforce and the deletion will sync for both.
- Merge: If you enable the appropriate settings in Apollo, you can merge duplicate records in Salesforce and the changes will sync to Apollo. Once you merge a duplicate, Apollo will only sync information for the remaining record with Salesforce.
To change these settings, launch Apollo and click Settings > Integrations. Click View for the Salesforce integration, and then click Edit for the Salesforce authentication settings.
Here, you can adjust the deletion and merge sync settings for the Salesforce integration.
If you pull duplicate records from Salesforce and then merge them in Apollo, Apollo does not merge them in Salesforce. To prevent the records from syncing again, either delete them or merge the duplicate in Salesforce.
Map Fields
If you decide to enable autofill or auto overwrite for mapped fields, keep the following in mind:
- When you select Autofill, Apollo automatically uses information within the Apollo database to fill in the field from Salesforce. This only happens if a field is empty and Apollo has relevant information available.
- When you select Auto Overwrite, Apollo automatically overwrites the existing information in the field from Salesforce with the information within Apollo. This only happens if the information differs between the 2 platforms and Apollo has relevant information available.
To configure autofill or auto overwrite, refer to the Map Default Apollo Fields in Salesforce article. Autofill and auto overwrite only run when Apollo pulls information from Salesforce.
Manual actions always take precedence. If you manually enrich a field from the CRM Enrichment page, Apollo pushes that update even if you have disabled the autofill or auto overwrite setting for the field.
View Errors
Leverage the error log in Apollo to view any sync errors that Apollo receives from your Salesforce instance.
The error log only displays errors that Apollo receives when pushing information to Salesforce. These errors are responses from Salesforce, and they usually indicate a restriction on Salesforce's side, such as hitting a custom validation rule or rate limits for your connected instance.
If you are still unsure whether your data is syncing correctly, you can gain a more granular view of error sync history at the contact or account level.
Now that you know more about how the Apollo-Salesforce integration works, you are ready to set up the integration! Start by following the steps in the Salesforce Credentials Overview article.
Also, don't forget to check out the Salesforce section of the Knowledge Base for more info on all things SFDC.