HubSpot destination

Prerequisites for setting up HubSpot Loader

1. The first step is to set up the loader within Meiro Integration by following the instructions given in this article.
   

After you finalize the first step, you can proceed with the following:

2. Set up the loader as a destination in CDPCDP. This step is described below in this article.

After3. you finalize all previous steps, you can proceed with exportingExport segmented customer profiles to the destination. ReferRead tohere. this article.

Destination ID (required, not editable)

"The Destination ID" is a numeric value that analysts will refer to within the Meiro Integrations environment. After you choose the ID, it will not be possible to change it later on.

Find the right workspace in Meiro Integrations, with  the CDP component responsible for the data load:

Check Destination ID in Meiro Integrations:

Insert Destination ID in the Meiro Business Explorer.

Name (required)

The name will be visible across the Meiro Business Explorer for the users (Data tab/ Source & Destination tab, segment detail)

Description (optional)

It is possible to add a description to the destination. The description will be displayed for use in the Data tab/ Sources & Destination tab.

Icon (required)

The icon will be visible across the Meiro Business Explorer for the users (insights, Data tab/  Attributes, Sources & Destinations,  segments, customer profiles).

Exported & Mandatory   attributes

(required)

"Exported attributes" - values of exported attributes will be sent to the dedicated Meiro Integrations workspace, then to the destination.

"Mandatory attributes" all customers in the export must have those attributes' values known.

For this destination, both "exported attribute" and "mandatory attribute" are:

Exported Attributes: Email is required. Other attributes are optional, depending on the use case (e.g. Name, Phone, Product Recommendations). 

Mandatory Attributes: Email

Meiro Integrations

(required)

"MI workspace" refers to the workspace in Meiro Integration which will be executed when the segment is exported.

To run exports you need to know the name of the workspace. You should get the name of the respective workspace from the Meiro data analyst.

Meiro data analyst takes care of the Meiro Integration's workspace preparation, and data transformation for a specific destination (e.g. Facebook, Twitter, Google Analytics). Each destination requires a different (very specific) data structure.

Parameters: One of list-name or list-id is required

Meiro Integration key: one of list-name or list-id is required

• If list-id is provided, the component will expect the list already exists and will update the contacts in it
• If list-name is provided, the component will create the list with a given name and populate it

If both list-id and list-name are provided, the component will update the contacts, however, will NOT rename the list in case a different name is provided

Name: List name / List ID

The name will be displayed for the user in the segments export parameter section.

Required field: non ticked

This field is not required to be filled.

Value from list: non ticked

Ticked makes a possible selection from the value drop-down list. Unticked - disables a drop-down list.

User Input: ticked

This field is required to be filled in order to HubSpot.

Exportable

Exportable shows how many customers will be exported to your destination.

This number is defined by the conditions you choose to segment the audience but also by mandatory attributes that have been set up by the administrator (that must be present to export to your destination).

For example, if you segment 1000 profiles but only 10 profiles have mandatory attributes present, only those 10 will be exported to your destination.

Mandatory attributes are visible in the Data tab/ Sources & Destinations tab.

For exports to HubSpot, the mandatory attribute are:

Email

Parameters

One of the list-name or list-id is required

• If list-id is provided, the component will expect the list already exists and will update the contacts in it
• If list-name is provided, the component will create the list with a given name and populate it

If both list-id and list-name are provided, the component will update the contacts, however, will NOT rename the list in case a different name is provided

Data Requirements

Input file structure

• Component expats export.ndjson file
• Each line contains one contact object that will be exported to HubSpot
• Email address is required
• Each additional JSON attribute on the contact object will be pushed to HubSpot contact as a custom property.

Example

{"email": "Sun@bar.com", "first_name": "marek", "last_name": "langer", “product” : { “product-name” : “Race Car”, “product-price: “15”, “product-category: “Car miniatures”  } }
{"email": "jane@doe.com", "first_name": "Jane", "last_name": "Doe",
“product” : { “product-name” : “Lego”, “product-price: “25” } }
{"email": "michal.tomcanyi@meiro.io", "Michal": "Tomcanyi", "phone_number": "420731145567"}

Does export create a new audience or update an existing one?

If list-name is provided, the component creates a new Contact List

If list-id is provided, the component updates contacts in the Contact List.

The Contact List must exist in this case or the component will fail.

Can I add a new contact list?

Yes. When you provide a List Name but no List ID, the component creates a new Contact List.

Can I update the existing contact list with new customers?

Yes. Provide an existing List ID, and the component will add or update the contacts in the list based on email. Contacts are never deleted from the list.

Are there any limits for exports?

There are no (known) limits on the number of contacts.

What data is exported to HubSpot?

Only emails will be exported to HubSpot in the most simple use case. However, additional attributes can be exported as well, including nested JSON objects.