HubSpot

Polytomic connects to HubSpot using OAuth and requires a HubSpot account with read-write permissions. While not required, we recommend you create a user in HubSpot exclusively for Polytomic so that the import logs in HubSpot distinguish Polytomic syncs from manual uploads.

1. In Polytomic, go to Connections → Add Connection → HubSpot.

2. Click Connect to HubSpot to authenticate to your HubSpot instance using OAuth.

3. Click Save.

Syncing from HubSpot

Use Bulk Syncs to sync from HubSpot to your data warehouses, databases, and cloud storage buckets like S3.

Use Model Syncs to sync from HubSpot to your SaaS applications.

Static list support

If you want to sync to/from HubSpot static lists, check the box on the connection that says Include static list support. Note that this will consume more HubSpot API calls.

Incremental pulls from HubSpot

If you want to incrementally sync from HubSpot to your data warehouse, turn on the Use HubSpot incremental API for bulk syncs checkbox on the connection. Due to limitations in HubSpot, this will not capture deletes. So either leave this off if you need deletes captured or set a periodic resync schedule using Polytomic's multiple schedules feature.

Syncing to HubSpot

Use Model Syncs to sync to HubSpot from your databases, data warehouses, SaaS applications, spreadsheets, and APIs.

📘

HubSpot sandboxes

Note that HubSpot sandboxes only accept 200,000 Contacts. If you sync more than that amount into a sandbox instance, expect records beyond the first 200,000 to be rejected by HubSpot.

Update-only-mode speed optimization

For syncs to HubSpot in Update-only mode, you are welcome to use any field as your identity value as with all other modes. However, if your source system (e.g. data warehouse) has the HubSpot record ID, we recommend using that as your identity value as that will result in much faster syncs to HubSpot.

Matching against Contact 'Additional emails' field

When syncing to HubSpot Contacts, you can have Polytomic also match against email addresses in HubSpot's 'Additional emails' field. This comes at the expense of extra HubSpot API calls if turned on, so it is off by default. If you'd like to turn it on, you can do in the Advanced settings section in your sync config:

Matching against Company 'Additional domains' field

In the rare case where your HubSpot Company records each have multiple domains, you can have Polytomic match against these additional domains. This comes at the expense of extra HubSpot API calls so is off by default. If you'd like to turn it on, you can do so in the Advanced settings section in your sync config: