YouPrep documentationHelp centerGet a demo

🔌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.

Hubspot Developer Console
Hubpot Manage App Menu

  • Click on Create app.

HubSpot_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
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
      HubSpot_app_add_redirect_uri

  • Scroll down to the Add a required scope part:

HubSpot_app_add_scopes
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
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
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
HubSpot_private_app_private_apps_menu

  1. Fill out the basic information form.

HubSpot_private_app_basic_info
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
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
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).

Last updated

Was this helpful?