🔌Setting up a Hubspot connector

Configuring a Hubspot connection

Warning

This connector is deprecated. It is recommented to use the HubSpot connector with Private Apps instead.

Create hubspot application

This connector is used to retrieve data from the HubSpot API: HubSpot API Documentation

The email events part relies for now on Hubspot’s legacy API: HubSpot legacy API Documentation

Create a HubSpot application¶

First, you need to create a HubSpot application. To do so, you will need a registered HubSpot developer account:

• Head over to Manage apps.

Hubpot Manage App Menu

• Click on Create app.

HubSpot_create_app

• Once the App Info is filled, click on the Auth part, you’ll see the following:

HubSpot_auth_app_layout

• Scroll down to the “Redirect URL” part and fill up the redirect URI.

  • The redirect URI should be like the following pattern:

    • https://api-{your-instance-name}.toucantoco.com/oauth/redirect?type=Hubspot

    

    HubSpot_app_add_redirect_uri
• Scroll down to the Add a required scope part:

HubSpot_app_add_scopes

• Then add any combination of the following scopes :

  • contacts

  • content

  • forms

  • business-intelligence

  • e-commerce

• Note that the connector will not work on certain types of data if a scope listed above is not added to the required scopes of your HubSpot application.

• Do not forget to click on the Save button at the bottom of the page when all your modifications are finished.

How to connect¶

Once your HubSpot application is created, you will need to set-up the client_id and client_secret credentials of your previously created application.

Look at Set up OAuth2 credentials for your platform for more information.

Once the credentials are set-up, you will need to configure your data provider. All of the pulled data is taken from your HubSpot application, whether it’s about email campaigns, companies, deals, etc.

Authentication to Hubspot

A pop-up window will open and look like this, click on the account that you wish to link to your connector:

HubSpot_create_connector_step_4

On the next window, all the scopes that are required by the application are displayed; a confirmation is required to link your connector to your hubspot account, just click on Connect app to do so:

HubSpot_create_connector_step_5

You will be redirected to your instance with a new popup with two fields: name and Auth Flow ID. Auth Flow ID should be pre-filled and name empty.

Field	Format / Type	Description	Example
Name (mandatory)	String	Use it to identify your connection	MyHubspotConnection
Auth Flow Id (mandatory)	String	Automatically filled by Hubspot
Retry Policy (optional)	Boolean	Boolean allows to configure a retry policy if the connection is flaky. max attempts: maximum number of retries before giving up max_delay: in seconds, above the connection is dropped wait_time: time in seconds between each retry
Slow Queries' Cache Expiration Time (optional)	Integer	Slow queries cache expiration time in seconds

Create a dataset from a Hubspot connection

Once the data provider is configured, it is possible to add one (or more!) data source that will provide data for your apps.

The HubspotDataset parameter is needed to define the kind of data you want to query in the following list:

• contacts (default value)

• companies

• deals

• products

• web-analytics

• email-events

The HubspotObjectType and parameters parameters are needed for the web-analytics dataset:

• parameters is a dict-like object that will contain filters that you want to use to filter the resulting data

  • The key must follow this schema: objectProperty.{property}, where property is a value defined in HubSpot’s documentation

  • The value can be anything

• HubspotObjectType has only one value for now (contact) but this may evolve in the future

Once you are all set, just hit SAVE

Configuring a HubSpot (with a private application) connection ¶

This connector is used to retrieve data from the HubSpot API: HubSpot API Documentation

Create a private application

To create one, follow these steps:

1. Go to the Settings page of your HubSpot account (click on the small gear in the top right corner of the page).

2. Head over to the Account Setup/Private Apps section.

3. Click on the Create a private app button.

HubSpot_private_app_private_apps_menu

1. Fill out the basic information form.

HubSpot_private_app_basic_info

1. Click on the Scopes tab. Toucan needs a read access on all CRM objects you want to query. The following objects are supported:

   • companies

   • contacts

   • deals

   • owners

   • quotes

2. Once you’ve ticked all the scopes you need, click on the “Create app” button.

HubSpot_private_app_scopes

1. You will now need to copy your app’s access token: Click on the View access token button, and then on Copy in the pop-up.

HubSpot_private_app_view_access_token

Now that your HubSpot private application is created, you can create a connection

Field	Format / Type	Description	Example
Name	String	Use it to identify your connection	MyPrivateHubspotConnection
Access token	String	Access token field previously seen in the configuration (will be stored as a secret)

Create a dataset from a Hubspot datasource¶

The HubspotDataset parameter is needed to specify the kind of data you want to query. Pick the desired dataset (note that your private app needs to have the right scopes for that), and click on Validate (or Run preview if you want a preview of your data first).