Hubspot Destination
PremiumThis feature is available on our Premium and Enterprise plans. UpdatedAbout this integration
HubSpot is an all-in-one CRM and Marketing tool. It helps you attract new leads, convert them into paying customers, and retain them with features like landing page creation and email automation.
There are two versions of this integration
You’ll see two entries for Hubspot in our integration catalog, with one labeled Web. We typically recommend that you use the standard destination, the one not labeled “Web” when possible. The web version of this integration only works with our JavaScript client and does not pass data through Customer.io’s servers, which can make it hard to debug your integration, capture a history of events sent to the destination, and so on. Learn more about Web destinations.
Getting started
Go to the Data Pipelines tab and click Connections.
Click Add New under Destinations.
Select the Hubspot destination.
(Optional) Select the sources that you want to connect to this destination. You can always connect sources to your destination later. We’ll only show you sources that you can use with your destination.
Configure your destination.
- Portal Id: The Hub ID of your HubSpot account.
Click Enable Destination.
Actions
When you’re done setting up your integration, you can go to the Actions tab to see how we map incoming data to your outbound integration.
You may need to add actions for this integration
While we often have default triggers for actions, we don't always add those actions as defaults. You may need to add actions to make sure that you're sending all the data that you want to send to your destination. See our actions page for help setting up actions.
| Action | Default Trigger | Description |
|---|---|---|
| Send Custom Behavioral Event |
| Send a custom behavioral event to HubSpot. |
| Upsert Contact |
| Create or update a contact in HubSpot. |
| Upsert Company |
| Create or update a company in HubSpot. |
| Upsert Custom Object Record | Upsert records of Deals, Tickets or other Custom Objects in HubSpot. |
Getting started: web destination
Go to the Data Pipelines tab and click Connections.
Click Add New under Destinations.
Select the Hubspot destination.
(Optional) Select the sources that you want to connect to this destination. You can always connect sources to your destination later. We’ll only show you sources that you can use with your destination.
Configure your destination.
Portal Id: The Hub ID of your HubSpot account.
Enable European Data Center: Enable this option if you would like to load the HubSpot SDK for EU data residency.
Flush Identify Immediately: Enable this option to fire a
trackPageViewHubSpot event immediately after eachidentifycall to flush the data to HubSpot immediately.Format Custom Behavioral Event Names: Format the event names for custom behavioral event automatically to standard HubSpot format (
pe<HubID>_event_name).Load Forms SDK: Enable this option if you would like to automatically load the HubSpot Forms SDK onto your site.
Click Enable Destination.
Web destination actions
When you’re done setting up your integration, you can go to the Actions tab to see how we map incoming data to your outbound integration.
| Action | Default Trigger | Description |
|---|---|---|
| Track Custom Behavioral Event |
| Send a custom behavioral event to HubSpot. |
| Track Page View |
| Track the page view for the current page in HubSpot. |
| Upsert Contact |
| Create or update a contact in HubSpot. |
FAQ and Troubleshooting
Why don’t my custom events show up in Hubspot?
HubSpot has limits for custom behavioral events that don’t necessarily apply to source data, like a limit on the number of event properties per event. Each event can contain data up to 50 properties. If your source data goes over this limit, HubSpot truncates incoming events to the first 50 properties in each event. See HubSpot for other limits.
My objects aren’t companies. How do I send other objects to HubSpot?
Our default group action references companies. But if you want to create records for other types of objects in Hubspot, you can use the Create Custom Object Record action.
For example, to create a deal in HubSpot, you’d add a new Create Custom Object Record action, set up your Trigger criteria, and input a literal string of “deals” as the Object Type. You can use the Properties object to add fields that are in the deals object, like dealname and dealstage.
You can follow this same process for other types of objects (tickets, quotes, etc). Note that you can only send custom fields inside the Properties object, including associations. We do not support record updates for custom, non-company objects; you can only create new records this way.
How do I send Page events to HubSpot?
The Page View action is only available when you use this destination in web mode. If you use this destination in its normal mode, you can set up a Custom Behavioral Event to send page data to Hubspot. You’ll also need to follow Hubspot’s instructions to create a custom behavioral event for Page Viewed in HubSpot.
