Skip to main content

Affinity Integration Guide

Connect Grata to your CRM

Written by Brendan Mahoney

Establish the Connection

  1. Go to the Account page

  2. Scroll down to Integrations and select Affinity

  3. A pop-up will appear

    1. Enter your Base URL from Affinity

    2. Enter your API Key

      1. This can be found in Affinity by clicking Settings > Manage Apps > New App > name the app "Grata" and save the API key that is generated.

      2. If you do not see see these options, contact your Affinity representative.

  4. Congrats! You are connected.


Company Mapping

Company Mapping is where you decide which Affinity fields are populated during a sync from Grata. Note: Company Domain must be mapped to Domain or Website. It cannot be mapped to a custom field (ie. "Grata Company Domain") or else syncs will fail.

(*) asterisks mark required fields.


All mappings besides Name & Company Domain are optional. If you choose not to map to a corresponding Affinity field, Grata won't ever send data to that field.​

Affinity Lists​

During this optional step, you can set Grata with a default list. Selecting this dropdown means that each time a net-new company is synced from Grata, the company goes into that specific list in Affinity.



Turning on Match companies only to selected list means that Grata will not look across your entire Affinity database for matchings-- only those companies in the selected list will be considered a match for Grata. This also has effects on filters like Only show companies in my CRM, or CRM Intel fields.


Replace Toggles

Replace ON (blue)

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

  • Grata will populate blanks in that field.

Replace OFF (gray)

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

  • Grata will not populate data for blanks.

  • Grata will populate the field only while it is creating a new company in Affinity.

Static Mappings

This setting makes it so that Affinity is populated with a fixed, predefined value for a certain field, each time a company is synced — regardless of the specific data that is on the Grata profile.

For example, set Prospect Status equal to "Open Lead" — so that, once in Affinity, each net-new target has the correct status of Open Lead.

Additional Guides for Affinity Custom Fields


Contact Mapping

Contact Mapping is the step where you decide which Affinity People data gets populated any time Companies & Contacts are synced.

(*) asterisks mark required fields:

Job Title Filtering

There is an optional step to filter Job Titles for contacts. By selecting specific titles, you can filter out unwanted contacts from flowing to your Affinity.


Opportunity Mapping

As an alternative to Organizations & People. you can make Grata sync directly into an Opportunity in Affinity. Change the Records to Sync dropdown in Step 1.


Pull info from my CRM into Grata

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

Pull info from my CRM is the feature that allows Grata to check for matches in your Affinity. This feature is the driver behind filters such as Show my companies, where you can filter down Grata profiles to ones that match your CRM.


Can I turn this off?

Yes, you can turn off Pull info from my CRM; this makes Grata a one-way integration. However, it is recommended to leave this feature on, as Grata will be "blind" to Affinity, which means it cannot index company matches— thus slowing down syncs.

How often does Grata check for matches?


Grata refreshes weekly. If you have access to the Auto-Update feature, you can set this to run daily, or monthly.


Auto-Update Companies & Contacts in my CRM

This feature runs automatic data enrichment. When it comes to deciding which Affinity data gets overwritten, Grata follows the mappings you saved.

Enrich All Companies

Grata enriches all Affinity records it finds a match with. This also includes companies added to Affinity from sources outside of Grata. Note: this option will consume more credits.

Only Update Synced Companies

Grata enriches only companies you have synced from Grata before.

How often does Grata enrich data?

By default, Grata enriches Affinity weekly. If you have access to Auto-Update, you can change the Auto-Update Frequency by clicking on the blue calendar icon.

How do I prevent my data being overwritten?

Data is controlled at the field-by-field level; only fields where the Replace toggle is ON will be overwritten (see: Company Mapping). This means Grata can overwrite Employee Headcount in Affinity, while never touching your Priority field, for example.


CRM Intel

CRM Intel is the feature allowing you to display Affinity-specific data on your views in Grata. If you have list-specific fields from Affinity, Grata can display those, too.

CRM Intel fields are accessible in multiple areas of the Grata platform: Company Search, Conference Pages, Buyer Search, Banker Search, and more. They are a direct reflection of your Affinity fields, and they are read-only.

Grata checks for updates in Affinity on a scheduled basis. If a Grata profile is displaying outdated information from Affinity, click Sync to have it refresh.


Note: once CRM Intel is enabled, all your Grata seats can view the Affinity fields.


FAQ

Does Grata share my Affinity data?

No. The connection is a secure data pipeline between your Grata instance and CRM— existing solely to benefit your search experience. Grata has its own proprietary data, and will not use your CRM data for any other purpose in the platform.

Read more about our data policy on the Integrations and Data Privacy FAQ.


​How does Grata prevent duplicates?

Grata knows to avoid creating duplicate companies. Before syncing, Grata will check for a matching Website. Grata recognizes a match regardless of whether the company is spelled amazon.com or http://www.amazon.com in your CRM.

Grata knows to avoid creating duplicate contacts, as well. It will check for First Name + Last Name of the person. It then checks for a match to the person's email.

How do credits work?

Each Grata profile equals 1 credit. The amount of Affinity fields— or the amount of contacts Grata has for that company— do not factor into the credit calculation.

Once a company has been synced to Affinity— after the first time— any sync thereafter of that company uses zero credits. The same company can be exported to Excel without costing additional credits.

How do I disconnect?

If you need to disconnect Grata from Affinity, you can do so from the Account page. Click the three dots under the Affinity tile, then choose Disconnect Affinity from Grata. Stored credentials are immediately wiped.

I ran into an error while syncing. What should I do?

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 syncing history & credit usage?

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?