Skip to content

Connect and use HubSpot data sync

Last updated: October 17, 2024

Available with any of the following subscriptions, except where noted:

All products and plans

With HubSpot data sync, you can create a one-way or two-way sync between HubSpot and your other apps to unite all of your customer data in one platform. Review which apps use data sync here

Before you begin

  • You must be a super admin or have App Marketplace permissions in your HubSpot account.
  • There may be other permissions required for the specific app you're connecting to your HubSpot account. 

Connect the app

There are two ways to search for and connect to an app. You can do so via the App Marketplace, or through the imports page. 

  • In your HubSpot account, click the Marketplace icon marketplace in the top navigation bar, then select App Marketplace.
  • In the search bar, enter the app name, then click the search result
  • In the top right, click Install app.
  • In the dialog box, click Next, then log in to your app account.
  • Review the requested access permissions, then click Allow. You'll be redirected back to the app page in your HubSpot settings.

If you're setting up a sync from the imports page:

  • Click Import in the top right of any object home page, or access your import settings:
    • In your HubSpot account, click the settings settings icon in the top navigation bar.
    • In the left sidebar menu, navigate to Import & Export.
    • Click Go to import.
  • Click Set up a sync

data-sync-import

  • In the right panel, enter the app name, then click the search result
  • Click Install app
  • You'll be redirected to the app's listing page to continue with the connection steps. 

It's possible to connect more than one instance of the same third-party app to HubSpot. For example, if you're managing two Microsoft Dynamics accounts, you can connect and sync data from both accounts with one HubSpot account. To connect an additional account:

  • In your HubSpot account, navigate to Data Management > Integrations.
  • Click the name of the app
  • Click Actions Manage accounts
  • In the right panel, click Connect another account
  • Proceed with the steps to connect the app to HubSpot. 

Turn on data sync

After connecting the app, you will need to configure your app settings and turn the sync on to begin syncing data between the two integrations. 

  • In your HubSpot account, navigate to Data Management > Integrations.
  • Click the app.
  • Click Set up your sync.
  • On the Choose an object to sync page, select the object you want to sync, then click Next. Learn more about syncing contacts and leads to other apps.

Configure your sync direction

On the Configure screen, choose the sync direction and map the third-party app’s fields to HubSpot properties. 

In the Choose your sync direction section, decide how you want data to sync from HubSpot to the third-party app, and vice versa. There are three options: 

  • Data syncs between apps: all new and updated object information will be synced between the two apps. Properties will be merged for records that already exist in both platforms. 
  • Data syncs only to HubSpot from your third-party app.
  • Data syncs only to your third-party app from HubSpot

In the Resolve data conflicts section, click the dropdown menu and select the default app that will overwrite the other when there are data discrepancies. If there’s no field value in the default app, no data will be changed in the third-party app. This setting does not overrule the sync direction selected in the Choose your sync direction section.

data-syc-resolve-conflict

Review your field mappings

In the Map your fields section, review the default property mappings and how information syncs between HubSpot and your third-party app. If you have a paid Operations Hub subscription, you can set up custom mappings for properties. If you do not have a paid Operations Hub subscription, click Try out custom mappings to test the function. 

Required fields will show in the field mappings table with an asterisk (*). 

To turn off a mapping, click to turn the toggle off

toggle

To set up a custom field mapping:

  • Click Add a mapping
  • Use the dropdown menus to select the third-party app and the HubSpot property you want to map.
  • Click success Update.
data-sync-custom-mapping
  • To turn off custom mappings, click to toggle the switch off. 

Learn more about specific rules and considerations for data sync field mappings

Set up your sync rules

On the Limit screen, configure how you want to sync records from HubSpot to your third-party app, and vice versa.

By default, HubSpot will only sync contacts that have a valid email address. To also sync contacts without an email address, in the Reduce the chance of duplicates section, clear the Only sync contacts with an email address checkbox.

During the initial sync, HubSpot will compare both databases. When a match is detected, existing records will be updated. Data sync matches contact records by comparing the contacts’ email addresses, then the company email address, name, and domains.

For company records, data sync matches company records in each app based on either company name or company domain name. For some connectors, the connector can only use name as the main identifier, as some apps don’t have a domain field. The HubSpot company domain name property must be defined as a default field mapping to be used as an identifier for deduplication. The HubSpot Website URL property cannot be used for deduplication. 

Please note: when an app has both a company name and company domain field, HubSpot will match two records if they have the same company name but a different domain, and vice versa.

In the Limit which records sync section, choose criteria to limit which records will sync from HubSpot to your third-party app, and vice versa:

  • Click Edit.
  • In the right panel, select the property to limit records syncing from HubSpot to your third-party app, and vice versa.
  • Click Done
advanced-filtering-data-sync

Please note: the Limit which records sync section only limits which records initially sync between HubSpot and the third-party app. Once records sync, they will continue to sync data back and forth based on the property mapping set up.


Associate records

HubSpot attempts to maintain the same associations between records (e.g., companies associated with contacts, or deals associated with companies) when syncing with the original app you connected, whenever possible.

To view records associated with contacts syncing from your other app:

  • Click the Actions dropdown menu on any of your object syncs, then select Edit sync settings
  • Click Configure.
  • In the Map your fields section, click the All mappings dropdown menu and select Association mappings
  • You will see the record syncing from the third-party app and its association to the object. 

Associated records will only be created if there’s a sync running for that same object. For example, if you have only a contact sync but no company sync, the associated company will not be kept in sync.

If a record has multiple company associations, only the primary company will be synced. 

Please note: in most cases, data sync can only automatically associate invoices to contacts. Invoices must be manually associated to company records in HubSpot. 

Review rules and start the sync

In the Review screen, review the rules you’ve configured, then click Save and sync. The initial sync will then begin to process.

data-sync-processing

After the initial sync is complete, records will sync within 10 minutes of a change. 

Resync deleted records

If you've deleted records in either HubSpot or your third-party app, you can resync deleted records to recreate them in either app:

  • In your HubSpot account, navigate to Data Management > Integrations.
  • Click the app.
  • On the Object view tab, in the Failing column, click the number of records that are failing to sync. 
  • In the right panel, click Actions.
  • Select either Resync deleted records in HubSpot or Resync deleted records in [third-party app].
resync-deleted

  • Click Resync all

You can also:

  • On the Record view tab, click More Restore all deleted records
  • In the side panel, click the Record type dropdown menu and select the record type and the Destination app dropdown menu to select which app to recreate the contacts in. 
  • Click Review before restore
  • Review all the records that will be restored, and click Restore all [number]

Turn off data sync

You can turn off data sync to prevent records from the app from syncing from HubSpot, and vice versa. 
  • In your HubSpot account, navigate to Data Management > Integrations.
  • Click the app.
  • Click the Actions dropdown menu and select Turn off sync.

turn-off-sync

  • In the pop-up box, click Turn off sync.

Once the sync has been turned off, you can turn it on again by clicking Edit sync settings, or delete the sync. 

Review your sync health

After connecting an app, view an overview of the records syncing between HubSpot and your third-party app. 

  • In your HubSpot account, navigate to Data Management > Integrations.
  • Click the app.
  • On the Sync overview tab, click Object view to view the sync status by objects.
    • In the In sync column, click the number of records to review all records syncing between HubSpot and the app.
    • In the Failing column, click the number of records to view all records failing to sync between HubSpot and the app. 
      • In the Error category column, review the reason for failure. 
      • Hover over the tooltip to review steps to resolve.
    • In the Excluded column, click the number of records to view all records excluded from sync. This could be because they do not match any of the filters in your sync settings, or they do not have a unique identifier assigned to them. Review the identifier for each object type in the table below: 
HubSpot object Identifier
Contacts or Leads Email address
Companies Company name and/or Domain name
Products SKU or Product name
Deals No specific identifier
Invoices No specific identifier
Tickets No specific identifier
Activities (calls, emails, tasks, notes, meetings) No specific identifier

 

  • Click Record view to view all records syncing between HubSpot and the app.
    • Use the dropdown menus to filter the records by object type, syncing status, or a specific time frame.
    • To edit the order of the columns, click MoreEdit columns
    • To export all records, click MoreExport
      • In the dialog box, select the file format
      • Click Export. The exported file will be emailed to you.
    • To restore all deleted records, click More Restore all deleted records.
      • In the right panel, select the Record type and Destination app. All previously deleted records will be restored in the selected destination app
Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.