This article is an overview of the functionality you can get from the two-way HubSpot integration with Pendo, and how it works. For information about how to set up the integration, see Set up the two-way HubSpot integration.
This integration is different from the one-way HubSpot integration that preceded the two-way HubSpot integration. For information about the one-way HubSpot integration, see HubSpot integration (legacy).
As well as pushing and pulling visitor and account data between Pendo and HubSpot, you can send Pendo events to HubSpot, allowing you to use specific Page, Feature, and Track Event data in customer health scores and outreach campaigns. For more information, see Push Pendo events into HubSpot.
Overview
The two-way HubSpot integration with Pendo provides a holistic view of your product usage and customer engagement in Pendo and HubSpot, respectively. With this integration, you can set up the connection between HubSpot and Pendo to do one or all of the following:
- Pull HubSpot information, such as account history and revenue, into Pendo to provide additional data points for segmentation, analytics, and guide-targeting.
- Push Pendo visitor data, account data, or both into HubSpot to help customer-facing and marketing teams get a more complete view of customers.
Broadly, “pull” refers to the process of collecting inbound data from hubSpot to Pendo, and “push” refers to the process of sending outbound data from Pendo to HubSpot. Pulling HubSpot information into Pendo enables more segmentation, allowing you to use HubSpot properties to filter analytics and target guides. Pushing Pendo usage analytics into HubSpot provides additional data for your teams that are in HubSpot, but aren’t necessarily in Pendo.
Prerequisites
- An active Pendo subscription.
- Admin user permissions in Pendo.
- Access to the HubSpot integration.
- An active HubSpot account with read and write access to the HubSpot API.
Use cases
By pulling HubSpot data into Pendo, you can use CRM data to:
- Target guides based on your customer segments and marketing campaigns.
- Report on product usage by customer tiers, pricing, or account status.
- Combine product insights in Pendo with trial conversion or upsells in HubSpot.
- Find the features and usage patterns that result in increased revenue.
By pushing Pendo visitor and account data into HubSpot, you can:
- Build a more complete view of customer interactions and use this insight to improve customer satisfaction and retention.
- Create targeted outreach campaigns, identify sales opportunities, and build customer relationships based on product usage and sentiment data.
- Use behavior data to optimize and automate your marketing strategies through action-based workflows.
By sending Pendo events to HubSpot, you can:
- Transform product engagement metrics into customer health scores that you can use to improve customer satisfaction and retention.
- Identify sales opportunities and create targeted outreach campaigns based on specific product usage.
- Use in-product behavior data to optimize and automate your marketing strategies through action-based workflows.
How it works
The HubSpot integration involves setting up a connection (mapping) before setting up either or both a push and a pull between Pendo and HubSpot. Both mapping and setting up a push and pull involve selecting fields belonging to the visitor and account objects in Pendo or properties belonging to the contacts and companies objects in HubSpot, but for different purposes.
-
For mapping, you select:
- One HubSpot contact property with values that match one-to-one with Pendo Visitor IDs.
- One HubSpot company property with values that match one-to-one with Pendo Account IDs.
- For setting up a pull, you select one or more HubSpot properties to add to Pendo as visitor and account metadata.
- For setting up a push, you select one or more Pendo fields to send to HubSpot, bundled as properties into a "property group".
After mapping objects and setting up a push or pull, you must then enable the integration to start automated daily syncs, which occur between midnight and 1am (UTC).
Mapping
Pendo data is grouped into two objects: a visitor object and an account object. These objects provide two possible bidirectional connections with the following HubSpot objects: contacts and companies.
- Visitors in Pendo connect with contacts in HubSpot.
- Accounts in Pendo connect with companies in HubSpot.
Before setting up a push or pull, you must first map Pendo objects to HubSpot objects. The data associated with Pendo objects are called "fields". The data associated with HubSpot objects are called "properties". For each Pendo object you want to connect with HubSpot, you must map the individual property of a HubSpot object to the corresponding Pendo object. This is the "Join Key".
- The Pendo Visitor ID field should map to the matching HubSpot Contacts property. For example, if you've set the Visitor ID in Pendo to be email, choose the "Email" property.
- The Pendo Account ID field should map to the matching HubSpot Companies property. This is typically something like "Company ID".
At this point, you're only setting up the connection between unique identifiers, not a pull or push. The unique identifiers are used for setting up both the pull and push functionalities, but the fields themselves aren't involved in a push or pull. Rather, the values of the fields that belong to the Pendo and HubSpot objects, chosen during the pull and push setup process, are pulled and pushed.
The account and visitor sync doesn't create a company or contact in HubSpot. You can only connect an account in Pendo to an existing company in HubSpot and a visitor in Pendo to an existing contact in HubSpot. If you want Pendo to create contacts in HubSpot, see Send Pendo events to HubSpot.
Setting up a "pull"
Pulling HubSpot data into Pendo involves selecting HubSpot properties belonging to one or both of the contacts or companies objects to add as metadata to visitors and accounts (respectively) in Pendo. You can use the resulting visitor and account metadata for segmentation in guides and analytics, and add these to your reports to view your CRM data in Pendo. Visitors and accounts are only synced if they've been active in one of your applications within the last 180 days.
Setting up a "push"
Pushing Pendo data into HubSpot involves selecting one or more Pendo visitor and account fields to send as properties in HubSpot. Visitors and accounts are only synced if they've been active in one of your applications within the last 180 days.
The fields you can push to HubSpot include:
- First Visit. The date of the visitor or account's first activity in Pendo.
- Last Visit. The date of the visitor or or account's last activity in Pendo.
- Usage Trending. The percentage change in activity between the last 180, 90, or 30 days and the 180, 90, or 30 days before that.
- Latest Poll Response. For a visitor push only, the latest response for a selected survey. This includes numerical and open responses to NPS surveys.
- NPS Score. For an account push only, the NPS numerical score calculated for a selected NPS survey from the past 180 days.
- Poll Average. For an account push only, an average of a selected Number Scale Poll from the past 180 days.
- Days Active. Number of days within the last 180, 90, or 30 days that the visitor or account has been active in the application.
- Time on App. Number of minutes that the visitor or account spent in the application within the last 180, 90, or 30 days.
- # of Total Visitors (account push only). Number of visitors belonging to an account.
The fields you push are bundled together into a Pendo “property group” in HubSpot, allowing HubSpot users to see what properties were created from Pendo fields.
Duplicate contacts and companies
If multiple HubSpot contacts or companies map to a single Pendo visitor or account, respectively, we remove all versions of the duplicate from the sync. This means that neither the Pendo visitor or account nor the HubSpot contact or company is updated.
Send events to HubSpot
In addition to syncing account and visitor data between Pendo and HubSpot, you can push Pendo Page, Feature, and Track Event data into HubSpot as "custom events".
It's recommend that you configure a HubSpot visitor sync before sending Pendo events to HubSpot. This allows Pendo to sync visitors using their HubSpot Record ID instead of email.
If the visitor associated with an event isn't yet a contact in HubSpot, this integration can create the contact in HubSpot.
For instructions, see Send Pendo events to HubSpot.