HubSpot Web

HubSpot is a CRM - it lets you keep track of all your customer leads. With the Freshpaint->HubSpot destination, you can create leads in HubSpot and send events to HubSpot based on your Freshpaint data.

Compared to the HubSpot Cloud integration, this integration only supports web as a source.

In general we recommend using the HubSpot Cloud integration when possible.

Destination Info

• Accepts Page, Track, and Identify calls

• Connection Modes:

  	Client-side	Server-side
  Web
  Mobile
  Server

Getting Started

To set up the HubSpot Web destination, follow the following steps:

1. In HubSpot, find your HubSpot Account ID under your profile dropdown and configure it in Freshpaint.

   

   
2. Enable the desttination.

Identify

Calls to freshpaint.identify() are mapped to the HubSpot identify API call. Calling freshpaint.identify() will either create a new contact in HubSpot or update the existing contact in HubSpot. HubSpot deduplicates users based on the user's email.

HubSpot requires an email to identify users. The email can be provided either as the userID passed to freshpaint.identify() or as a user property passed to freshpaint.identify(). If no email is provided, the freshpaint.identify() call will not call the HubSpot identify API.

You'll see contacts created from Freshpaint in the Contacts section of HubSpot.

Here is an example of an identify call:

freshpaint.identify({
 "email": "[e-mail]",
 "name": "Ada Lovelace"
});

Events

Events are mapped to the HubSpot trackEvent API Call. After sending an event to HubSpot you can use the HubSpot tooling to analyze the events and create reports on the data. Note that there is a 24 hour delay for when events will show up in HubSpot reporting.

HubSpot events are only supported on the HubSpot Marketing Hub Enterprise tier.

Page Views in Hubspot

Calls to freshpaint.page() are mapped to the HubSpot trackPageView API call . Calling freshpaint.page() will create page view events in HubSpot.

Integration Option

Within the Integration Option, the HubSpot destination is referred to as "HubSpot". If you want an API call to not go to HubSpot, you can use the following code:

freshpaint.identify(
  userID, 
  userProps, 
  {"integrations": {"HubSpot": false}}
);

If you want an API call to go to HubSpot and no other destinations, you can use the following code:

freshpaint.identify(
  userID, 
  userProps, 
  {"integrations": {"All": false, "HubSpot": true}}
);

Configuration Options

Connection Mode Settings

Only client-side connection mode is available for this destination. Events originating from the user's web browser will be sent directly to HubSpot.

Event Transformations

Set up transformations to modify your data before it's sent to your destination. Read more about transformations here.

API Call Limitations

HubSpot has limits on the total amount of hourly and daily requests Freshpaint can make to their API on your behalf. See HubSpot’s API Usage Guidelines for more information.

HubSpot Plan: Free & Starter

• Maximum Number of API Calls per 10 Seconds, per Key or Token: 100

• Maximum Number of API Calls per Day, per Key or Token: 250,000

HubSpot Plan: Professional and Enterprise

• Maximum Number of API Calls per 10 Seconds, per Key or Token: 100

• Maximum Number of API Calls per Day, per Key or Token: 500,000

HubSpot Plan: API Add-On (Any Tier)

• Maximum Number of API Calls per 10 Seconds, per Key or Token: 120

• Maximum Number of API Calls per Day, per Key or Token: 1,000,000