Send audiences to HubSpot

HubSpot is a CRM platform built around dedicated hubs for marketing, sales, services, content management, and operations.

This topic describes the steps required to configure campaigns to send email address lists to HubSpot.

Note

Field names that are sent from Amperity to HubSpot should be lowercase and contain only letters (a-z), numbers (0-9), and underscores (_). Amperity automatically converts uppercase letters to lowercase and replaces non-underscore characters (such as #, *, or -) with an underscore.

Important

HubSpot has specific requirements for email address validation . All email addresses that are sent to HubSpot must:

  1. Have a valid format, as defined by RFC 2822 .

  2. May not contain quotation marks in the local part of the address, which is the part to the left of the @ symbol.

  3. Must end in a valid top-level domain (TLD), as listed at https://data.iana.org/TLD/tlds-alpha-by-domain.txt and may contain Unicode characters within the TLD.

If a list of email addresses that is sent to HubSpot contains a single invalid email address the entire import will fail and return a 400 error.

If you experience a 400 error (due to invalid email addresses), identify which email addresses are invalid, remove them from the list, and then resend a list of valid email addresses to HubSpot.

Amperity will update contacts that already exist in HubSpot; Amperity does not create contacts.

Note

Ask your DataGrid Operator or your Amperity representative for help configuring HubSpot as a destination to which you can send campaigns for customer activation.

Build a segment

Use the Segment Editor to build any audience using a series of drop-downs and picklists.

As you define the attribute profile for an audience be sure to refresh segment insights to view audience size and to see the value it brings to your business.

When the segment is ready, activate it, and then use it use it in a campaign to send to your preferred destinations for customer activation.

Which attributes should you use?

You can use any attribute that is in your customer 360 database to define your audience.

When sending the list of customers who belong to this audience to HubSpot as part of a campaign you must choose specific attributes to send.

HubSpot supports the following attributes: email address lists.

Add to a campaign

Use the campaign editor to configure Amperity to send data to HubSpot. Add a segment, define exclusions and sub-audiences, and then define each audience sent to HubSpot.

To add HubSpot to a campaign

Step 1.

Open the Campaign Editor. This is available from the Campaigns page. Click the Create campaign button in the top right corner of the page.

Step 2.

Assign HubSpot as a destination for at least one treatment group.

Add a destination for HubSpot.

Note

You may need to edit the attributes for the sub-audience to ensure Amperity is sending the right data to HubSpot.

Step 3.

Click Edit attributes to review the attributes that Amperity sends to HubSpot.

HubSpot requires only email addresses. There are no optional fields.

Amperity pre-selects the list of attributes sent to HubSpot. The Edit attributes page for HubSpot is similar to:

Edit the attributes for HubSpot.

Note

The Merged Customers table is the default table for sending data to HubSpot, even though segments are often built against the Customer 360 table. This is by design. The Merged Customers table is the underlying table for customer profile data and is the source for all customer profile data that exists within the Customer 360 table.

Configure default attributes

Each unique destination configured to send treatment group audiences to HubSpot has a set of default attributes.

Configure default attributes by clicking the Default attributes link next to the Create campaign button on the Campaigns page.

The source table defaults to the Merged Customers table for most attributes. This is configurable.

HubSpot has the following requirements for attributes.

Source attribute

Destination attribute

email

email