Skip to main content

HubSpot 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 HubSpot

  3. A login portal will appear

    1. Enter your username and password from HubSpot

    2. HubSpot will ask for approval— scroll down to approve the connection

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

      2. Contact our support team if you have trouble connecting.

4. Click Get Started.


Company Mapping

Company Mapping is where you decide which HubSpot properties are populated during a sync from Grata. Company Domain must be mapped to Company Domain Name. It cannot be mapped to a custom property (such as Grata Custom Domain) or syncs will fail.

(*) asterisks mark required fields.


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


Replace Toggles

Replace ON (blue)

  • Grata will override that property, including any companies in HubSpot that already have data in that property.

  • Grata will populate blanks in that property.

Replace OFF (gray)

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

  • Grata will not populate data for blanks.

  • Grata will populate the property only while it is creating a new company in HubSpot.

Static Mappings

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

For example, set Lead Status equal to "New" — so that, once in HubSpot, each newly added company begins with New.

Additional Guides for HubSpot Custom Properties

  • For a comprehensive list on each Grata data point and its definition, please refer our Grata Field Definitions.

  • For a list of supported property types in HubSpot, please refer to this document (recommended types are shown in bold).


Contact Mapping

Contact Mapping is the step where you decide which HubSpot contact 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 HubSpot.


Pull info from my CRM into Grata

Before you setting the properties 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 HubSpot. 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 your CRM, 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 HubSpot data gets overwritten, Grata follows the Company Mapping you saved.

Enrich All Companies

Grata enriches all HubSpot records it finds a match with. This also includes companies added to HubSpot from sources other than 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 HubSpot 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, while never touching the Priority, for example.


CRM Intel

CRM Intel is the feature allowing you to display HubSpot-specific data on your views in Grata.

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 HubSpot properties, and they are read-only.

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


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


FAQ

Does Grata share my HubSpot 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 Company Domain. 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 HubSpot properties— or the amount of contacts Grata has for that company— do not factor into the credit calculation.

Once a company has been synced to HubSpot— 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 HubSpot, you can do so from the Account page. Click the three dots under the HubSpot tile, then choose Disconnect HubSpot 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?