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
contactsandcontact listsin 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.

2
Under All Destinations, search for HubSpot.

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.
d. In the new screen that appears, sign in to your HubSpot account with your existing credentials.
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.
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 
g. Click Next to proceed to mapping.



contacts and contact lists within the HubSpot account.
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.
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.
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.
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.
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.
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.





Link an audience to the destination
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.

2
Under Lists, click the list you want to check. This displays the contacts included in that list.

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.