Link Custom Salesforce Fields to Custom Apollo Fields

Article author
Apollo Team
Updated

Overview

While Salesforce provides many out-of-the-box fields that you can use to sync your data back and forth between Apollo, there may be data that is important to your business that you can't track with traditional metrics. For this reason, Apollo and Salesforce allow you to create custom fields to store that data.

In order to use bidirectional syncing between Apollo and Salesforce, you need to create a custom field in Salesforce and then link that field to a custom field in Apollo.

 
Build Before You Bridge

Create custom fields in Salesforce for each object type, like contacts, accounts, or deals, before you link them to to the corresponding field in Apollo.

Check out the following sections to link custom fields between Salesforce and Apollo.

Back to Top

Create a Custom Salesforce Field

To create a custom field in Salesforce, check out Create a Custom Field on Salesforce Support.

  1. Launch Salesforce and then click Quick Settings > Open Advanced Setup.
  2. Click Object Manager.
  3. Apollo supports custom fields for Account, Contact, Lead, and Opportunity fields. Select one of these options to create a custom field for that object type.
  4. Within the object, click Fields & Relationships.
  5. Click New to create a new custom field.
  6. Select the Data Type you want to use for your custom field, then click Next.
 
Corresponding Types

Select the same or similar data type in both Salesforce and Apollo to prevent data sync errors.

  1. Fill in the required and optional fields for your new custom field, then click Next.
  2. Configure the security details for your custom field, then click Next.
  3. Select the page layouts that should include your new custom field, then click Save.

You have now created a new custom field in Salesforce.

The new field appears under Fields > Relationships in Salesforce. You can now link this field to a custom Apollo field.

Back to Top

Map Custom Fields

To map a custom field from Salesforce to Apollo:

  1. Launch Apollo and click Settings > Integrations, then click Salesforce.
  2. Click Contacts, Leads, Accounts, or Deals, depending on the type of record you want to map.
  3. Click Fields.
  4. Click Add field mapping.

Field mapping dropdowns highlighted for contact fields

  1. Check the Apollo fields you want to map.
  2. Then click Add field.

Field mapping dropdowns highlighted for contact fields

  1. Map the fields between Apollo and Salesforce.
  2. When finished, click Save.

You have now mapped Apollo deals fields to Salesforce opportunity fields.

 
Field Fusion

Apollo supports linking custom contact fields to either a Salesforce contact field or Salesforce lead field, depending on which option makes the most sense for your integration. You can also sync to both object types at the same time. If you decide to sync to both object types, the Apollo custom contact field automatically becomes read-only.

Back to Top

Next Steps

Ready to keep your Salesforce ↔ Apollo sync tight and tidy? Here are a few handy next steps for you and your team.

Important Information about the Salesforce Integration Give your team a solid foundation and review the key behaviors and limitations to avoid sync surprises down the line.
Integrate Salesforce with Apollo If you're still wiring things up, connect Salesforce with Apollo end-to-end to keep activities, contacts, and accounts flowing cleanly between both systems from day one.
Configure Salesforce Pull Settings You can tune Salesforce pull settings to control exactly when and how updates from Salesforce flow into Apollo so your reps always work from fresh, relevant records.
Configure Salesforce Push Settings Next, configure Salesforce push settings to decide which Apollo changes write back to Salesforce so your CRM stays useful without getting spammed with noise.
Map Default Apollo Fields to Salesforce Round things out by mapping default Apollo fields to Salesforce so core contact, account, and deal data always lands in the right spot before you layer on custom fields.

Back to Top