Sync custom objects between HubSpot and data sync apps

Learn how to sync custom objects between HubSpot and data sync apps. Syncs can be one-way or bi-directional.

Before you get started

• You must create the custom object in your HubSpot account before setting up the custom object sync. 
• Currently, it's possible to sync custom objects with the following data sync apps:

• • Airtable (tables)
  • Kintone (tables)
  • Microsoft Dynamics 365 (entities)
  • Smartsheet (sheets)
  • Snowflake (make sure your HubSpot account is opted into the Snowflake beta)
  • Zoho CRM (modules)

Set up your custom object sync

Set up your custom object sync with your data sync app.

Turn on data sync

To turn on your custom object sync:

1. Connect the app to your account.
2. In your HubSpot account, click the settings settings icon in the top navigation bar. In the left sidebar menu, navigate to Integrations > Connected Apps.
3. Click the app.

• • If this is the first time you're syncing an object, click Set up your sync.
  • If you have other objects already synced, click Sync more data.

4. On the Select the data you want to sync page, select the object to sync to or from in the other app.
5. Select the custom object you want to sync to or from in HubSpot. Custom objects are located under Additional objects.

6. Click the arrows dropdown menu, and select whether the sync is bi-directional or one way between the app and HubSpot, or vice versa. 
7. Click Next.

Configure your sync direction and mapped fields

On the Configure page, choose 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: data will be synced from your third-party app to HubSpot.
• Data syncs only to [your third-party app]: data will be synced from HubSpot to your third-party app. 

In the Data conflict resolution section, click the dropdown menu and select the default app that'll 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 doesn't overrule the sync direction selected in the Sync direction section.

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

Set up your sync rules

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

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

1. Click Edit.
2. In the right panel, select the property to limit records syncing from HubSpot to your third-party app, and vice versa.
3. Click Done. Then click Next. 

Please note: the Filters 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

When syncing with a custom object, associations won't be maintained. It is recommended to map them manually.

Review rules and start the sync

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

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