Customerlabs CDP Documentation

You are here:

(A ‘Source’ platform is one where data can be brought in from any platform into CustomerLabs CDP)  

HubSpot is an easy-to-use platform that helps companies capture new leads & convert them into paying customers, with marketing automation and CRM capabilities.  

Marketing teams connect HubSpot with CustomerLabs CDP to send their Company, Contacts & Deals related information to create unified customer profiles in CustomerLabs CDP and sync the enriched customer data to all their favorite tools in their tech stack. 

Here are some popular CRM growth tactics that marketers run with HubSpot data using CustomerLabs CDP. 

Getting started

Rather than making an API call when an event happens in a connected account, HubSpot will send an HTTP request to CustomerLabs CDP via webhook. The below steps will help you integrate HubSpot as a Source with your CustomerLabs CDP account without writing any code. 

1. Login to CustomerLabs CDP → Sources → Connect Source

Sources in the CustomerLabs CDP app

2. Select HubSpot from the list of Sources

Hubspot connection in the CustomerLabs CDP sources

3. Click on Authenticate HubSpot

Hubspot authentication in the CustomerLabs CDP

4. You will be redirected to your HubSpot account

5. Post login, Choose the HubSpot account that you want to link with CustomerLabs CDP

CustomerLabs CDP Hubspot integration to sync data from Hubspot to CustomerLabs CDP

6. Grant CustomerLabs CDP to access HubSpot Contact & Account details. 

Hubspot integration with CustomerLabs CDP

7. You will now be prompted to select the CustomerLabs CDP account that you want to link HubSpot with. (in case you have multiple accounts choose one)

CustomerLabs accounts in the dashboard showing all the accounts.

8. Voila! Your HubSpot account is now linked with CustomerLabs CDP 

Hubspot Authentication in CustomerLabs CDP

9. You can add the custom fields created in HubSpot using the Custom Field Configurations section. The standard fields will be notified by default but the custom fields should be added here. Note: Maximum of 10 custom fields can be added for each module.

Custom Field Configurations. Configure hubspot custom fields here and standard fields.

HubSpot Webhook Subscriptions

Once you’ve finished the integration, HubSpot will begin sending all default event subscriptions to CustomerLabs CDP. 

Webhook event subscriptions in HubSpot consist of 

  • Object type (Company, Contacts, Deals) 
  • Events (Created, Deleted, Property Changed, Deleted for Privacy) & 
  • Properties

Learn more about HubSpot event subscriptions here. 

Building Workflows in CustomerLabs CDP

Note: A Contact in HubSpot is referred to as a User in CustomerLabs CDP. A Company in HubSpot is referred to as an Account in CustomerLabs CDP.

Setting up a workflow in CustomerLabs CDP will allow you to receive notifications about changes that happen to your HubSpot data in real-time. 

For example, you can set up a workflow that will trigger a notification to be pushed to CustomerLabs CDP every time a contact/company/deal has been updated in your HubSpot account.

Workflows help in filtering incoming data to suit business needs and map them to existing customer data in CustomerLabs CDP, thus achieving a unified customer view without writing any code. 

CustomerLabs CDP aggregates multiple user & account identifiers such as Google Analytics Client ID, Facebook ID, website ID etc. over a period of time by integrating with other marketing tools. 

Incoming user data from HubSpot will be mapped to existing user & account identifiers using advanced identity resolution

All workflows below will be triggered for ‘property changes’ subscription. 

  • contact.propertyChange – To get notified if a specified property is changed for any contact in a customer’s account.
  • company.propertyChange – To get notified if a specified property is changed for any company in a customer’s account.
  • deal.propertyChange – To get notified if a specified property is changed for any deal in a customer’s account.

Workflow #1 – How to send data to CustomerLabs CDP when a new contact is created in HubSpot

The below steps explain how you can filter and map incoming contact information from HubSpot to Customerlabs CDP

1. Give a name to your workflow and before proceeding, Create a test contact in HubSpot to get related data samples. Once a new contact is created, click on Choose sample data.

Workflow set up event data into CustomerLabs CDP

2. Click on Fetch new data view relevant event samples in CustomerLabs CDP. 

Data selection to fetch new data into CustomerLabs CDP from HubSpot

3. Click on View details to know more about incoming information. In the case of HubSpot, all incoming contact fields will be sent in different samples. You can find only the contact email in a sample as shown below

Sample raw data inside CustomerLabs CDP showing all the audience data.

4. Likewise, contact first name, last name, lifecycle stage etc, will be sent as different events. But the common user ID parameter here will be the object ID

first name parameter highlighted in the Raw data inside CustomerLabs CDP

5. Now select any 1 contact related event sample by clicking on “Select this sample” and hit Filter

Raw data along with user parameters and javascript sent into CustomerLabs CDP

6. The filter screen acts as a roadblock to stop other non-related event data coming in from HubSpot & skew existing information.

7. Click on “Create filter criteria” to give your filter condition – this will allow only “contact.propertyChange” event from HubSpot to enter this workflow in the future.

8. Choose the Event type from the dropdown.

Filter incoming data

9. Add condition and make sure to give the Event name as it is shown in the sample data. 

Filter incoming data using subscription type text contains contact.propertyChange

10. Here’s a detailed breakdown of the event configuration screen 

11. Give a name to your incoming event. You can select a predefined event name as shown below or give a custom name based on your requirements. 

Event configuration with custom event

12. User Identity mapping lets you combine all user-related events, since an incoming contact has an email address & is assigned a HubSpot Object ID we can select two identifiers (identify_by_email and hubspot_user_id) from the drop-down and assign relevant values.

user identity mapping screenshot

13. Once the user mapping is done, you can categorically map other incoming information into different buckets as shown below,

14. Below is the list of Contact Subscriptions that will be sent to CustomerLabs CDP when a Contact is created in HubSpot. You can add them to relevant buckets with the help of the table below.

15. Additional custom properties created can be mapped under relevant CustomerLabs CDP attributes based on requirements

Object: Contact

PropertyEventsCustomerLabs CDP Attributes
ext_idcontact.propertyChangedUser External IDs
salutationcontact.propertyChangedUser traits
firstnamecontact.propertyChangedUser traits
lastnamecontact.propertyChangedUser traits
emailcontact.propertyChangedUser traits
phonecontact.propertyChangedUser traits
mobilephonecontact.propertyChangedUser traits
faxcontact.propertyChangedUser traits
usertokencontact.propertyChangedUser traits
addresscontact.propertyChangedUser traits
statecontact.propertyChangedUser traits
citycontact.propertyChangedUser traits
zipcontact.propertyChangedUser traits
countrycontact.propertyChangedUser traits
lifecyclestagecontact.propertyChangedUser traits
jobtitlecontact.propertyChangedUser traits
hs_languagecontact.propertyChangedUser traits
messagecontact.propertyChangedUser traits
closedatecontact.propertyChangedUser traits
websitecontact.propertyChangedUser traits
numemployeescontact.propertyChangedUser traits
industrycontact.propertyChangedUser traits
associatedcompanyidcontact.propertyChangedUser traits
twitterhandlecontact.propertyChangedUser traits
followercountcontact.propertyChangedUser traits
twitterprofilephotocontact.propertyChangedUser traits
hs_personacontact.propertyChangedUser traits
hs_analyticssourcecontact.propertyChangedUser traits
hs_legal_basiscontact.propertyChangedUser traits

Workflow #2 – How to send data to CustomerLabs CDP when a new company is created in HubSpot

The below steps explain how you can filter and map incoming company information from HubSpot to Customerlabs CDP

1. Give a name to your workflow and before proceeding, Create a test company in HubSpot to get related data samples. Once a new company is created, click on Choose sample data.

2. Click on Fetch new data view relevant event samples in CustomerLabs CDP. 

3. Click on View details to know more about incoming information. In the case of HubSpot, all incoming company fields will be sent in different samples. You can find only the company name in a sample below

4. Likewise, company city, state, address etc. will be sent as different events. But the common Account ID parameter here will be the object ID

5. Now select any 1 contact related event sample by clicking on “Select this sample” and hit Filter

6. The filter stops other non-related event data coming in from HubSpot & skew existing information

7. Click on “Create filter criteria” to give your filter condition – this will allow only “company.propertyChange” event from HubSpot to enter this workflow in the future.

8. Choose the Event type from the dropdown.

9. Add condition and make sure to give the Event name as it is shown in the sample data. 

10. Here’s a detailed breakdown of the event configuration screen.

11. Give a name to your incoming event. You can select a predefined event name as shown below or give a custom name based on your requirements. 

12. Account Identity mapping lets you combine all company events, since an incoming company data has a company name & is assigned a HubSpot Object ID we can select two identifiers (identify_by_company and company_id) from the drop-down and assign relevant values.

13. Once the account mapping is done, you can categorically map other incoming information into different buckets as shown below

14. Below is the list of Company Subscriptions that will be sent to CustomerLabs CDP when a Company is created in HubSpot. You can add them to relevant buckets with the help of the table below

15. Any additional custom properties created can be mapped under relevant CustomerLabs CDP attributes based on your requirements.

Object: Company

PropertyEventsCustomerLabs CDP attributes
namecompany.propertyChangedAccount traits
phonecompany.propertyChangedAccount traits
addresscompany.propertyChangedAccount traits
citycompany.propertyChangedAccount traits
statecompany.propertyChangedAccount traits
zipcompany.propertyChangedAccount traits
address2company.propertyChangedAccount traits
industrycompany.propertyChangedAccount traits
lifecyclecompany.propertyChangedAccount traits
hs_lead_statuscompany.propertyChangedAccount traits
websitecompany.propertyChangedAccount traits
domaincompany.propertyChangedAccount traits
hs_additionaldomainscompany.propertyChangedAccount traits
numberofemployeescompany.propertyChangedAccount traits
annualrevenuecompany.propertyChangedAccount traits
typecompany.propertyChangedAccount traits
descriptioncompany.propertyChangedAccount traits
closedatecompany.propertyChangedAccount traits
web_technologiescompany.propertyChangedAccount traits
twitterhandlecompany.propertyChangedAccount traits
twitterbiocompany.propertyChangedAccount traits
twitterfollowerscompany.propertyChangedAccount traits
facebook_company_pagecompany.propertyChangedAccount traits
linkedin_company_pagecompany.propertyChangedAccount traits
linkedinbiocompany.propertyChangedAccount traits
googleplus_pagecompany.propertyChangedAccount traits
hs_analytics_sourcecompany.propertyChangedAccount traits
founded_yearcompany.propertyChangedAccount traits
timezonecompany.propertyChangedAccount traits
facebookfanscompany.propertyChangedAccount traits
about_uscompany.propertyChangedAccount traits
total_money_raisedcompany.propertyChangedAccount traits
hs_target_accountcompany.propertyChangedAccount traits

Workflow #3 – How to send data to CustomerLabs CDP when a new deal is created/updated in HubSpot

Creating a deal in HubSpot involves assigning the deal to only a company, contacts or both company & contacts. The below steps explain how you can filter and map incoming deal information from HubSpot to Customerlabs CDP.

Scenario 1: Mapping incoming deal information when both company & contacts are assigned 

1. Give a name to your workflow and before proceeding, create a test deal in HubSpot to get related data samples. Once a new deal is created, click on Choose sample data.

2. If you experience any delays in receiving data from HubSpot, you can always choose the default data to set up. 

3. You can choose either deal create or deal update to set up the event if you have chosen default data or choose a relevant sample from the incoming data.

4. Once the data sample is chosen, proceed to filter incoming data.

5. The filter screen acts as a roadblock to stop other non-related event data coming in from HubSpot & skewing existing information.

6. For this scenario, you’ll have to create multiple filters. 

7. The first one to bring in HubSpot data when the event name has “deal.creation” and has both company-related data (assoc_company__0_companyId)  & contact-related data (assoc_contact__0_contactId). 

8. Secondly, create an OR condition to bring in HubSpot data when the event name has “deal.updation” and has both company-related data (assoc_company__0_companyId)  & contact-related data (assoc_contact__0_contactId). 

9. These filter conditions will allow only event data to enter CustomerLabs CDP when the deal created or updated has both company & contact information

10. Lastly, configure the event with incoming customer data 

11. Give a name to your event. Selecting “dynamic event” will let the CDP pick the name of the event based on the incoming information

12. Now choose how your contact can be identified by the CDP by selecting appropriate user identifiers. You can just choose to identify by email & select the assoc_contact_0__email as well as add another parameter like the HubSpot user object ID (assoc_contact_0__contactId)

13. In the same way, you can choose how your incoming company data can be identified by the CDP by selecting appropriate account identifiers. You can just choose to identify by website & select the assoc_company_0__website as well as add another parameter like the HubSpot account object ID (assoc_company_0__companyId)

14. Below is the list of deal-related data that will be sent to CustomerLabs CDP when a deal is created or updated in Hubspot. You can add them to relevant buckets with the help of the table below

PropertiesEvent name
companydeal.creation/deal.updation
dealnamedeal.creation/deal.updation
amountdeal.creation/deal.updation
dealstagedeal.creation/deal.updation
pipelinedeal.creation/deal.updation
createdatedeal.creation/deal.updation
closedatedeal.creation/deal.updation
descriptiondeal.creation/deal.updation
dealtypedeal.creation/deal.updation
closed_lost_reasondeal.creation/deal.updation
closed_won_reasondeal.creation/deal.updation
deal_currency_codedeal.creation/deal.updation
hs_campaigndeal.creation/deal.updation
hs_analytics_sourcedeal.creation/deal.updation
hs_deal_amount_calculation_preferencedeal.creation/deal.updation

15. You can map all the incoming information under account traits as shown below, 

16. Finally, add the Deal ID from HubSpot as an Account External ID as shown below, 

17. This will enable the system to associate all deal-related information to a company as well as all their contacts. 

Scenario 2: Mapping incoming deal information when only a company is assigned

1. Give a name to your workflow and before proceeding, create a test deal in HubSpot to get related data samples. Once a new deal is created, click on Choose sample data.

2. If you experience any delays in receiving data from HubSpot, you can always choose the default data to setup. 

3. You can choose either deal create or deal update to set up the event if you have chosen default data or choose a relevant sample from the incoming data.

4. Once the data sample is chosen, proceed to filter incoming data.

5. The filter screen acts as a roadblock to stop other non-related event data coming in from HubSpot & skewing existing information.

6. For this scenario, you’ll have to create multiple filters. 

7. The first one to bring in HubSpot data when the event name has “deal.creation”, has company-related data (assoc_company__0_companyId)  & does not have contact-related data (assoc_contact__0_contactId). 

8. Secondly, create an OR condition to bring in HubSpot data when the event name has “deal.updation”, has company-related data (assoc_company__0_companyId)  & does not have contact-related data (assoc_contact__0_contactId). 

9. Lastly, configure the event with incoming customer data 

10. By choosing “create or update group” the system will remove user identification parameters so that you’ll have to configure only the account identification parameters as shown below, 

11. Account identification parameters like the website (assoc_company__0_website) & HubSpot account object ID (assoc_company__0_companyId) will enable the CDP to identify incoming company data. 

12. You can map all the incoming deal information under account traits as shown below, 

13. Finally, add the Deal ID from HubSpot as an Account External ID as shown below, 

14. This will enable the CDP to associate all deal-related information only to a company.

Scenario 3: Mapping incoming deal information when only contacts are assigned

1. Give a name to your workflow and before proceeding, create a test deal in HubSpot to get related data samples. Once a new deal is created, click on Choose sample data.

2. If you experience any delays in receiving data from HubSpot, you can always choose the default data to setup. 

3. You can choose either deal create or deal update to set up the event if you have chosen default data or choose a relevant sample from the incoming data.

4. Once the data sample is chosen, proceed to filter incoming data.

5. The filter screen acts as a roadblock to stop other non-related event data coming in from HubSpot & skewing existing information.

6. For this scenario, you’ll have to create multiple filters.

7. The first one to bring in HubSpot data when the event name has “deal.creation”, does not have company-related data (assoc_company__0_companyId)  & has contact-related data (assoc_contact__0_contactId). 

8. Secondly, create an OR condition to bring in HubSpot data when the event name has “deal.updation”, does not have company-related data (assoc_company__0_companyId)  & has contact-related data (assoc_contact__0_contactId).  

9. Lastly, configure the event with incoming customer data. Give a custom name to your event as shown below, 

10. Now choose how your contact can be identified by the CDP by selecting appropriate user identifiers. You can just choose to identify by email & select the assoc_contact__0_email as well as add another parameter like the HubSpot user object ID (assoc_contact__0_contactId)

11. Map all the incoming deal information under user traits as shown below, 

12. Finally, add the Deal ID from HubSpot as User External ID as shown below, 

13. This will enable the CDP to associate all deal-related information only contacts are assigned.

Destination

Send incoming data to third-party apps to boost marketing effectiveness. Learn more about the destination tools we support.

Need assistance?

Have questions or facing issues? We can help set it up for free. 

Get in touch

Was this article helpful?
0 out Of 5 Stars
5 Stars 0%
4 Stars 0%
3 Stars 0%
2 Stars 0%
1 Stars 0%
5
How can we improve this article?
How Can We Improve This Article?
Need help?
Table of Contents
CustomerLabs gives freedom, flexibility and wings to digital marketers.
Sign Up

Schedule a 1-1 Demo

Ecommerce

Unified data to boost ecommerce growth

B2B

Engage your customers across the funnel with a unified martech stack

SaaS
Saas

Increase product metrics with a unified martech stack

Agency
Agency

Scale your customers quickly with the right data