Hubspot Destination

About 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.

This destination supports both cloud and direct modes

Hubspot supports cloud and direct modes. In general, we recommend that you use the cloud mode destination, so that you capture data in Customer.io and can easily debug your implementation, capture a history of events, and so on.

Getting started:cloud mode

  1. Go to the Data Pipelines tab and click Connections.

  2. Click Add New under Destinations.

  3. Select the Hubspot destination.

  4. (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 eligible sources.

  5. Configure your destination.

    Setup your destination
    Setup your destination

  6. Click Enable Destination.

Cloud mode actions

When you’re done setting up your destination, you can go to the Actions tab to see how we map source events to your destination.

You may need to add actions for this destination

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.

ActionDefault TriggerDescription
Send Custom Behavioral Event

type = “track”

Send a custom behavioral event to HubSpot.
Upsert Contact

type = “identify”

Create or update a contact in HubSpot.
Upsert Company

type = “group”

Create or update a company in HubSpot.
Create Custom Object RecordCreate records of Deals, Tickets or other Custom Objects in HubSpot.

Getting started:direct mode

  1. Go to the Data Pipelines tab and click Connections.

  2. Click Add New under Destinations.

  3. Select the Hubspot destination.

  4. (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 eligible sources.

  5. Configure your destination.

    1. Portal Id: The Hub ID of your HubSpot account.

    2. Enable European Data Center: Enable this option if you would like to load the HubSpot SDK for EU data residency.

    3. Flush Identify Immediately: Enable this option to fire a trackPageView HubSpot event immediately after each identify call to flush the data to HubSpot immediately.

    4. Format Custom Behavioral Event Names: Format the event names for custom behavioral event automatically to standard HubSpot format (pe<HubID>_event_name).

    5. Load Forms SDK: Enable this option if you would like to automatically load the HubSpot Forms SDK onto your site.

    Setup your destination
    Setup your destination

  6. Click Enable Destination.

Direct mode actions

When you’re done setting up your destination, you can go to the Actions tab to see how we map source events to your destination.

The actions for your destination
The actions for your destination

ActionDefault TriggerDescription
Track Custom Behavioral Event

type = “track”

Send a custom behavioral event to HubSpot.
Track Page View

type = “page”

Track the page view for the current page in HubSpot.
Upsert Contact

type = “identify”

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 directA direct destination (sometimes known as a web destination) receives data directly from your sources, bypassing Customer.io’s servers. Direct mode destinations only support our JavaScript source. mode. If you use this destination in cloud mode, you can setup 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.

Copied to clipboard!
  Contents
Is this page helpful?