Skip to main content

Salesforce Integration Setup

Set up company and contact syncing from Grata to your CRM

Brendan Mahoney avatar
Written by Brendan Mahoney
Updated over 3 weeks ago


Before You Begin

For Salesforce authentication, there are two approaches you can take to set up the Grata integration. The Salesforce user can be a:

  1. System Admin (one of your regular users)

    or

  2. custom integration user in Salesforce dedicated for Grata API activity

While option #1 is the simpler approach, option #2 is our best practice recommendation as it provides more security and traceability.

  • Grata's best practice uses the Minimum API Access standard profile from Salesforce. Our solution aligns with the Principle of Least Privilege.

  • To create this user in Salesforce, you can follow our User & Permissions Guide.

  • Reach out to Grata for more assistance with this option.


Establish the Connection

  1. Go to the Account page in Grata

  2. Scroll down to Integrations and select Salesforce

  3. A login portal from Salesforce will appear

    1. Enter your username and password

    2. Salesforce will ask for approval to connect— click approve

    3. If this portal does not appear, it may because you are already logged in to Salesforce within the same browser session

  4. Begin setting up a new connection


Sync Preferences

Before you begin mapping the specific fields you would like Grata to populate when syncing, select your CRM preferences.

Pull info from My CRM into Grata

Pull info from my CRM is how Grata pulls matching companies from your Salesforce. This feature is also the driver behind the Show companies in my CRM filter:

Pull info from my CRM runs once per week. If you need Grata to pull matching CRM records on a more immediate basis, contact Grata support.

Auto-Update Companies & Contacts in my CRM

This feature is how Grata does data enrichment on your CRM. When it comes to deciding which data should be overwritten, Grata respects the rules that you've set in Company Mapping.

Auto-update Companies & Contacts runs in the background whenever there is a change to a Grata company profile for one of the data points you have mapped. Within minutes, Grata automatically updates the matching account in Salesforce.


Does Grata share my data?

Grata does not use your CRM data for any other purpose in the platform. The connection with Salesforce is a secure data pipeline between your Grata and CRM, existing solely to benefit your search experience.

Read more about Grata's security policy with our Integrations and Data Privacy FAQ.


How does Grata prevent creating duplicates?

Grata knows not to create duplicate companies. Before syncing, Grata will check your CRM for the Website or Domain. Grata can recognize a match regardless of whether the spelling is amazon.com or http://www.amazon.com in your CRM.

Grata knows not to create duplicate contacts in your CRM. It will check for First Name + Last Name of the person. It then checks for a match to the person's email.

Can I test in a sandbox first?

Absolutely! You may test syncing to a Salesforce sandbox before opening up the syncing feature to all users. Please contact your Grata representative to get started.

How do I disconnect my CRM?

If for any reason you need to disconnect Grata, you can do so from the Account page. Click the three dots under Salesforce, then choose Disconnect Salesforce from Grata. API credentials — plus any CRM data— are immediately wiped.


Record Type Mapping

Before you dive into Company Mapping, select which Account Record Type(s) will be synced to in Salesforce, and which types will be pulled by Grata in Pull My CRM Info Into Grata.


Company Mapping

Company Mapping is where you decide which Salesforce data gets filled in during company syncs from Grata. Note: Company Domain has to be mapped to Website; it cannot be mapped to a custom field (e.g. "Grata Custom Domain").

(*) asterisks mark required fields.


The left column contains each data point that can sync to Salesforce. By clicking into a box, Grata displays the selection of supported Salesforce fields for that data point.

  • If you do not select a corresponding Salesforce field, Grata data will not push data to that field.

  • Replace Values ON (blue)

    • Grata will override that field, including any companies in Salesforce that already have data in that field.

    • Grata will populate blanks in that field.

  • Replace Values OFF (gray)

    • Grata will not update the value for matching companies in Salesforce, regardless of whether the field is blank, or has data.

    • Grata will populate the field only while creating a new company in CRM.

Additional Guides for Company Mapping

For a comprehensive list on each Grata field and what it means, please refer to Grata Field Definitions. For a list of supported Salesforce field types, please refer to this document (recommended field types are shown in bold).


Contact Mapping

Contact Mapping is the step during integration setup where you decide which Salesforce contact data gets populated any time that Companies & Contacts are synced.

(*) asterisks mark required fields:

Job Title Filtering

There is an optional step to select specific Job Titles for contact syncs. By unchecking certain job titles, you can prevent unwanted contacts flowing through to Salesforce during a bulk sync.

Change the dropdown for Which company contacts would you like to sync? to Select specific titles.

Lead Syncing

Grata can sync contact data to the Lead object instead of Contact. Change the the Connect Grata contacts to dropdown for Lead syncing. Note: Grata does not sync firmographic info (Company Website, Description, Revenue Estimate, etc.) to the Lead. It only syncs this data to the Account. Contact Grata to explore other solutions.


Pull Data from Salesforce Data into Grata

This feature, also known as "CRM Intel", is the ability for Grata to display information directly from your Salesforce on matching companies in Grata.

All CRM Intel fields are read-only. Grata checks for updates in CRM once per hour to display the latest information. Note: once turned on, that CRM field is visible to all Grata seats in your organization.


How do I know when my work is saved?

Your CRM integration settings are saved once you click Next on the final step of the setup screen.

What should I do if I run into an error while syncing to CRM?

If you need assistance with your CRM integration, reach out to Grata Support (support@grata.com) or chat with us in the Help section > Messages.

Where can I see my synC history?

To see logs on how many companies were synced, how many credits were used, and by whom, go to Accounts > Audit Log. For detailed information, such as how many contacts were synced, reach out to Grata Support.

Did this answer your question?