To install the HubSpot integration, you must have a HubSpot admin permissions to add and authenticate third party apps.
In the HubSpot Connector Dashboard, click the Settings tab. Here you can set the rules to map, filter & link incoming & outgoing data.
There are four sections of settings:
Hull can sync the following objects to HubSpot. New data is upserted in both directions - existing profiles are updated, else new profiles are created automatically.
Note: HubSpot Companies are not handled by default. You must configure this.
HubSpot Contacts and their updates are fetched into Hull manually or on a schedule.
When new data about a HubSpot Contact is ingested, Hull follows this process:
VID is captured as an
hubspot/id in Hull User profiles.
Note: If more than one Hull User exists with the same
VIDand without a unique external_id then they will be merged. A
User mergedevent will show the before/after difference in attribute values. Learn more about User merging
HubSpot Companies are not handled by default. This must be enabled in the Connector Settings under the Fetch accounts toggle.
You must select what account-level identifier to map into. This is
domain by default.
HubSpot Companies and their updates are fetched automatically on a schedule. This can be also be fetched manually in the Credentials & Actions tab.
When new data about a HubSpot Company is ingested, Hull follows this process:
domainfor default). Skip if not.
ID is captured as an
anonymous_id in Hull Account profiles.
Note: If more than one Hull Account exists with the same
domainand without a unique external_id then they will be merged. Learn more about Account merging.
Hull will associate Users and Accounts by a common
www.hull.io will be associated.
If you’d also like to match Users and Accounts in Hull by the Contact-Company relationships you have in HubSpot, you can configure this in the Connector Settings under the Link users in Hull toggle.
Hull will link Users with Accounts if:
If the HubSpot Company does not have a required identifier, the User will be associated with an empty Hull Account.
Hull Users must be in a whitelisted User Segment to be synced to HubSpot. By default, no Users are synced.
When Hull publishes a User Update for a User whitelisted to sync to HubSpot:
Hull Accounts must be in a whitelisted Account Segment to be synced to HubSpot. By default, no Accounts are synced.
When Hull publishes an Account Update for an Account whitelisted to sync to HubSpot
domain. Skip if not.
domainexists, sync Account Update to HubSpot
You can associate HubSpot Contacts and Companies based on logic you have in Hull. Click the Link Contacts in Hubspot toggle in the Connector Settings.
Hull will link Contacts & Companies in HubSpot if:
Filter which Users & Accounts are synced to HubSpot with User & Account Segments in the Connector Settings.
Map which User & Account attributes are synced to and from HubSpot with the field mappers in the Connector Settings.
|Standard Person Attributes||User Attributes||Contact Properties|
|Custom Person Attributes||User Attributes||Custom Contact Properties (grouped under |
|Standard Company Attributes||Account Attributes||Company Properties|
|Custom Company Attributes||Account Attributes||Custom Company Properties (grouped under |
All default HubSpot Contact & Company Properties are fetched and stored as a HubSpot attributes group on Hull User & Account profiles.
In the Connector Settings, under the Custom Fields Sync (HubSpot to Hull) headings for Users & Accounts, you can map and name HubSpot Custom Properties into Hull. These will also appear under the HubSpot attributes group on Hull User & Account profiles.
In the connector settings, under the Custom Fields Sync (Hull to Hubspot) headings for Users & Accounts, you can map Hull User & Account Attributes to Custom Properties in HubSpot Contact & Company profiles. These will appear under a Hull group in HubSpot.
You can configure each field for Hull to overwrite values in HubSpot.
You can create new properties in HubSpot from Hull field mapping. As you type right column of the field mapper, you’ll be prompted to “Create” the field you’re typing.
You can sync Hull User & Account Segments to HubSpot.
|Groups of people||User Segments|| |
|Groups of companies||Account Segments|| |
Hull ingests data from the HubSpot connector through the Firehose API.
Learn more about HubSpot’s API usage guidelines.
|HubSpot API limits||40,000 per day|
|HubSpot Rate Limits||10 requests per second|
|Bulk operation limitations||Batches of 100 contacts/customers|
|Fetch updates sync frequency||Every 5 minutes|
|Sync data from Hull to HubSpot||With every User or Account update|
Check you have setup identifiers for accounts. See data mapping
Check your connector logs for any
incoming.job.error. If you see any with
Permission error, you need to re-authenticate the HubSpot Connector. Go to the Credentials & Actions and perform the oAuth flow authorization again using the Start over button.
All your connector settings (including data mapping) will remain the same.
After re-authenticating, your data flow should resume. You can also run a Fetch all Contacts or Fetch all Companies in the connectors tab. Search the connector logs for
incoming.account.success to verify data is flowing again - this can take up to 5 minutes.
Note: Make sure you link with the same HubSpot portal. Changing the portal can lead to data corruption.
In the HubSpot Connector settings, go to Credentials & Actions and then click Fetch all Contacts for contact properties or Fetch all Companies for company properties.
It may take a few minutes for the import of data to be ingested and be shown in Hull.
You can manually sync the Users and Accounts to HubSpot. Go to the User or Account Profiles, or create a User or Account Segment then select the Send to button and choose HubSpot. Click confirm.
Make sure you set the required account identifiers in the Connector settings.
If you see
duplicate property value error in your
outgoing.account.error logs it means that you have duplicate entry in your outgoing attribute mapping.
You can inspect
hubspotWriteContact parameter in the logs to see the exact payload the connector tried & failed to send to Hubspot. Search for any attribute name which appears twice in the same payload. Once you have identified the duplicate attribute, remove the extra entry in the attributes mapper in the Connector Settings.
Once you have reconfigured you data mapping, resend the affected Users & Accounts to HubSpot with the Send to button on the Profiles or Segmentation tool.