Last updated: March 30, 2021
With HubSpot data sync you can create a one-way or two-way sync between HubSpot and your other apps.
Integration requirements
- You must be a Super Admin or have App Marketplace permissions in your HubSpot account.
Connect the integration
- During the BETA, click the link in your invite email.
- Click the dropdown menu and select the app you want to sync with.
- Click Connect [app].
- In the pop-up box, log in to your app account.
- Review the requested access permissions, then click Allow.
- You will be redirected back to the app page in your settings.
Please note: if you are using PieSync to sync data with HubSpot already, you will need to pause the connection.
Configure your sync settings
Turn on the sync
After connecting the app you will need to turn the sync on. You can configure a one-way or two-way sync for your data.
- In your HubSpot account, click the Marketplace icon in the main navigation bar. Under Manage, select Connected apps.
- Click the app.
- Click Set up your sync.
- On the Choose an object to sync page, click the object you want to sync between HubSpot and your selected app. Learn more about syncing contacts and leads to other apps.
Creating and updating contacts
Decide what happens when a contact is updated in the other app or HubSpot.
There are four separate configurations you can select:
- Two-way sync (Default).
- One-way sync from HubSpot to your other app.
- One-way sync from your other app to HubSpot.
- Use sync filters
One-way sync from HubSpot to your other app
This configuration will sync all new and updated contact information from HubSpot to your other app.
One-way sync from your other app to HubSpot
This configuration will sync all new and updated contact information from your other app to HubSpot.
Two-way sync
This configuration will sync all new and updated contact information from HubSpot to your other app and from your other app to HubSpot. For contacts that already exist in both platforms, their contact properties will be merged.
Use sync filters
Sync filters can be used to limit the scope of the sync. It is recommended to apply a filter each time you set up a sync. The filters that appear in the dropdown menus depend from app to app.
To test out your sync, you can create a static list with a small number of contacts first before setting it live for all or a larger set of contacts.
Set lifecycle stage
When a contact is created or updated by the app, you can assign a HubSpot lifecycle stage.
Please note: this setting will not appear for all apps. It will only appear for apps that have leads.
Handling duplicates
By default, HubSpot will only sync contacts that have a valid email address. You can turn this off by clearing the checkbox.
Deleting contacts
The integration will not delete contacts when they have been deleted in the other app.
Resolving data conflicts
When you have two-way sync enabled there may be some data conflicts that will need to be resolved. For example, in HubSpot, the First name of a contact is Dave while in the other app the First name of that same contact is David. This is a conflict that will be resolved by looking at the defaulting app. If there is no value in the field in the defaulting app, no data will be removed from the other app.
Please note: this setting does not overrule sync direction.
- When you're happy with your sync setup, click Review in the top right.
- Review your sync and click Save and sync.
The initial sync may take a while to run, when it is complete contacts will sync within 10 minutes of a change.
Turn off data sync
- In your HubSpot account, click the Marketplace icon in the main navigation bar. Under Manage, select Connected apps.
- Click the app.
- Click Actions > Turn off sync.
- In the pop-up box, click Turn off sync.
