Connect HubSpot and Google Contacts

Google Contacts is a contact management tool that allows you to organize, review, and merge your contacts in Google. Learn how to connect Google Contacts to HubSpot using data sync. 

Connect the app

1. In your HubSpot account, click the Marketplace icon marketplace in the top navigation bar, then select HubSpot Marketplace.
2. Search for and select Google Contacts.
3. Click Install. 
4. In the pop-up window, click Connect to Google Contacts.
5. In the dialog box, log into your Google account.
6. Review the requested access permissions, then click Allow. Then click Continue setup. You'll be redirected to the Google Contacts integration sync settings in HubSpot. 
7. Click Set up your sync to set up your sync rules. 

Configure your sync settings

After connecting Google Contacts, you'll need to configure your settings and turn the sync on to begin syncing data between the two integrations. 

1. In your HubSpot account, click the settings settings icon in the top navigation bar. In the left sidebar menu, navigate to Integrations > Connected Apps.
2. Click Google Contacts.
3. Navigate to the CRM syncs tab. 
4. Click Set up your sync. 
5. On the Select the data you want to sync page, decide how you want data to sync from HubSpot to Google Contacts, and vice versa. It's only possible to sync contacts with this integration. Click the sync direction arrows and select a sync direction between HubSpot and Google Contacts. You can choose from the following options:

• • Data syncs between apps: data syncs bi-directionally between HubSpot and Google Contacts. 
  • Data syncs only to Google Contacts: Google contacts will be created from HubSpot contacts based on criteria. Only Google Contacts properties will be created. 
  • Data syncs only to HubSpot: HubSpot contacts will be created from Google contacts based on criteria. Only HubSpot contact properties will be updated. 

6. In the upper right, click Next. 
7. Click the Data conflict resolution dropdown menu and select which app will overwrite the other when it's unclear which app has the most up-to-date information.
8. In the Mapped fields section set up your field mappings.

• • Default field mappings can't be removed or edited. To turn off a field mapping, click to toggle the switch off. 
  • To add a custom field mapping, click Add a mapping to set it up.

9. On the Limit page, in the Filters section, click Edit to add any filters to limit which contacts will sync from one app to the other. You can add multiple filters with AND or OR conditions. Then click Next. 
10. On the Review page, review your sync configuration and click Save and sync. 

Please note: the sync filters limit the scope of the sync but will not add contacts or companies to a segment with that filter.

Learn more about configuring your other sync settings.

Customize your field mappings 

The Google Contacts integration has 11 default mappings that cannot be edited. Learn how to add a new field mapping. Also, keep in mind the following limitations for the Google Contacts integration:

• The phone number that is listed first in Google Contacts in the Phones property will map to the Phones property in HubSpot. Any additional phone numbers in Google Contacts won't sync unless they are labeled as Mobile or Fax, in which case they will sync with the Mobile Phone Number and Fax Number in HubSpot respectively. 
• Existing custom text fields in Google Contacts cannot be synced to HubSpot. 
• Labels in Google Contacts cannot be synced with HubSpot properties.
• It isn't possible to sync the Owner property between HubSpot and Google Contacts.
• If there are multiple values in a property in Google Contacts, the first property value will be synced to the HubSpot property. 

Resolve sync errors

Google Contacts has a limit of 25,000 unique contacts, including contacts in the Other contacts and Trash folders. The maximum size of an individual contact is 128 KB. If you see the error Storage quota exceeded, follow these steps to resolve it:

• Empty the Trash and Other contacts folder.
• Delete any duplicate or unwanted contacts.
• Amend individual contacts so that they are below the size restriction of 128 KB. 

Learn more about other sync errors that you might encounter.