Skip to main content

What this is

The HubSpot destination sends audiences out of Zeotap CDP to HubSpot. Each audience you link is delivered into your HubSpot account as contacts, as a contact list, or both, ready to use in HubSpot campaigns. HubSpot is a CRM platform that helps you gather and use data to engage with your customers. Integrated with Zeotap CDP, it lets you manage and utilise your contact information efficiently. HubSpot appears in Zeotap CDP in both directions. Use this table to confirm you are on the right page: Two HubSpot concepts decide what this destination can do:
  • Contact — in HubSpot, a contact is the information held about an individual person: the user profile, with attributes such as first name, last name, cell phone number and email address.
  • Contact list — in HubSpot, a contact list is a segment or cohort of customers. You build the cohort as an audience in the Zeotap CDP Audiences application and push it to HubSpot as a list.
HubSpot only adds contacts (email addresses) that already exist in your HubSpot account to a contact list. Push the contacts (user profiles) from Zeotap CDP to HubSpot first, then add those contacts to the contact list.

Supported identifiers and actions

Zeotap CDP sends contact information to a contact list. Currently, only email addresses are sent as part of the contact list attributes. The following table lists the available action types for the integration and the delivery features supported for each: For Send Contact to Contact List, the raw email address of the contact is chosen by default as the output identifier. For Create Contact, the mapping carries the general profile attributes HubSpot needs for a contact — for example Email, First Name, Last Name, Phone, City, Country and Company. You can add custom attributes to the mapping with + Add Mapping Field.

Prerequisites

Have the following ready before you create the destination:
  • A HubSpot account — an active account on HubSpot. For how to create one, see Set up your HubSpot account.
  • Sign-in credentials for that account — you sign in to HubSpot during destination creation, and the connection grants Zeotap permission to manage the contacts and contact lists in that account.
  • The HubSpot account you want to send data to — if you manage more than one, see Manage multiple HubSpot accounts before you connect.
  • Contacts already present in HubSpot, if your goal is to populate a contact list. See the note under What this is.
  • An audience in Zeotap CDP to link to the destination, and a role that grants destination edit rights on the organisation that owns the destination. See Destinations: prerequisites.

Create the HubSpot destination

Perform the following steps to create the destination in Zeotap CDP:
1
Log in to the Zeotap CDP App and go to the Destinations application.
Destinations listing in the Zeotap CDP App, with the + Create Destination button highlighted above the table of existing destinations
2
Under All Destinations, search for HubSpot.
All Destinations catalogue in the Zeotap CDP App, with the destination search box highlighted above the destination cards
3
Click HubSpot. A screen appears with details about the destination on the left, and on the right the fields required to establish the integration. Enter the required details:a. Enter a name for the destination.b. Enter the Client name, which indicates the placeholder for the destination. As a best practice, and for easy identification, provide a name you can recognise the destination by.c. Click Connect HubSpot. You are redirected to the HubSpot login page.
Enter Destination Details screen for HubSpot in the Zeotap CDP App, showing the Destination Name and Client name fields above the Connect HubSpot button
d. In the new screen that appears, sign in to your HubSpot account with your existing credentials.
HubSpot connection screen offering Create a new HubSpot account or Sign in to your HubSpot account, with the sign-in option highlighted
e. Once connected, a screen appears where you choose the account you want to send data to. For more about handling several accounts, see Manage multiple HubSpot accounts.
HubSpot Choose an account screen, listing the HubSpot accounts available to connect with a search box and a Choose Account button
f. Once the connection between the Zeotap CDP App and your HubSpot account is established, you are redirected back to Zeotap CDP. The Access Token and Refresh Token are filled in for you, along with the expiry period for the access token. Through this connection, you grant Zeotap permission to manage the contacts and contact lists within the HubSpot account.
Enter Destination Details screen after the HubSpot connection is established, highlighting the Access Token, Access Token Expires In (second) and Refresh Token fields that Zeotap CDP fills in
g. Click Next to proceed to mapping.
4
In the new screen that appears, choose either Create Contact or Send Contact to Contact List as your action. For how mappings work, see Define the mapping.a. To create a contact in HubSpot:i. Under Choose your Action, choose Create Contact from the drop-down menu.
Choose your Action drop-down in the Zeotap CDP App, with Create Contact highlighted above Send Contact to Contact List
ii. Under Map the Fields, the general attributes needed to create a contact (user profile) are displayed. You can include custom attributes for the contact using + Add Mapping Field at the bottom left of the screen.
Map the Fields screen for Create Contact, pairing Catalogue fields with HubSpot destination fields such as Email, First Name, Last Name, Phone, City and Country, with + Add Mapping Field highlighted
iii. Review the fields and click Create Destination. The created destination gets listed in the Audiences application, where you can use it to send contacts (user profiles) from Zeotap CDP to HubSpot.
Mapping screen in the Zeotap CDP App with Create Contact selected under Choose your Action and the first Catalogue-to-destination field pairs listed under Map the Fields
b. To send a contact to a contact list in HubSpot:i. Under Choose your Action, choose Send Contact to Contact List from the drop-down menu.
Choose your Action drop-down in the Zeotap CDP App, with Send Contact to Contact List highlighted below Create Contact
ii. Under Map the Fields, the raw email address of the contact is chosen by default as the output identifier. Currently, only email addresses are sent as part of the contact list attributes.
Mapping screen with Send Contact to Contact List selected under Choose your Action and Email Raw mapped as the identifier under Map the Fields
iii. Review the fields and click Create Destination. The created destination gets listed in the Audiences application, where you can use it to send contacts to contact lists from Zeotap CDP to HubSpot.
For information about how to link an audience (segment) to the created destination in the Audiences application, see Link an Audience to the Destination. It can take up to three business days for segments to be available at the HubSpot seat.
The terms Audiences and Segments are used interchangeably to refer to customer cohorts belonging to a specific category. For example, an audience or a segment could be a specific group of customers who are over 18 years of age and who have performed an addToCart event within the last 30 days.

User disqualification from audiences

This integration supports user disqualification from audiences. A user can be disqualified from an audience (segment) for various reasons, such as not meeting the audience criteria, consent requirements or other conditions set for that audience.
  • When a user is disqualified from an audience, Zeotap CDP initiates a user deletion request in the next refresh cycle. These requests are sent to the audiences linked to the specific destination.
  • Disqualified users are excluded from the audiences based on the refresh frequency configured for that audience.
  • User disqualification is a programmatic process that works automatically. You do not need to specify anything to trigger the disqualification and exclusion of users from audiences.

Verify the audience reached HubSpot

Check both sides of the delivery. In Zeotap CDP — open the destination and confirm the linked audience recorded a run with a completed status and a non-zero qualified count. See Verify the activation worked. In HubSpot — perform the following steps to view the contact lists (segments) pushed by Zeotap CDP:
1
Log in to the HubSpot CRM platform and go to Contacts > Lists. This screen gives details of the segments, such as list name, list size and last updated date.
Lists screen in HubSpot under Contacts, showing the list name, list size, type, object, last updated and creator columns
2
Under Lists, click the list you want to check. This displays the contacts included in that list.
A static list open in HubSpot, showing its size in contacts and the contact rows with name, email, phone number and contact owner columns
The two counts will not match exactly. HubSpot adds to the list only those contacts that already exist in the account, so the list size is bounded by how many of the audience’s email addresses HubSpot already holds.

Troubleshoot the HubSpot destination

If the destination is configured correctly and the problem persists, read the error recorded on the audience–destination pair: Why deliveries fail lists the error strings that surface there, and When to contact support covers when to raise a ticket and what to include in it.

Next steps

Last modified on November 5, 2026