HubSpot

Get started with the HubSpot source!

Connector Details

NameValue
PlatformHubSpot
Auth TypeOAuth
Sync TypeIncremental
DirectionBidirectional
API versionREST API
Testing AccountFree Developer Account
Unified SchemaSupported in the CRM Schema

Connector Versions

NameVersionStageDescription
HubSpotv2GASupports raw HubSpot import and unified CRM schema with improved performance.
HubSpotv1DeprecatedSupports raw HubSpot import with limited performance.

Create OAuth app

📘

The HubSpot developer account is different from a normal HubSpot account. Make sure to register for a Developer Account or you will not see the Manage App options.

The first thing that you need to do to create a HubSpot OAuth app is to create a free HubSpot developer account.

Once logged into the HubSpot developer portal, your home page should look similar to this. Navigate to the Apps tab or click Manage apps.

On your Apps page, you should navigate to the Create App button on the top right hand side of your screen. Go ahead and click on the button.

On this page, make sure to name your Public app, upload your app logo, and add a description. Once you have done that, click Save.

The next step is to head to the Auth tab.

Next, you need to scroll down and set the Redirect URL to <https://hotglue.xyz/callback>

As you continue to scroll, you will now see the scopes section. This allows you to choose what your product will be able to pull out of HubSpot.

I have set up a sample configuration that allows Read access to every endpoint in the CRM. If you have questions about what your scopes should be, feel free to ask us!

🚧

Select the CRM Schemas endpoints

Please make sure you check off all of the scopes that begin with crm.schemas. You can see them above in the red outline.

The last thing you must check off for your app to work is the oauth scope. If you do not check off this scope, your users won't be able to connect! Once you are done configuring your scopes, click the Save button.

Now you should scroll up back to the top of your page and copy the Client ID and Client Secret into hotglue!

Make sure to paste the Scopes list (space separated) from your HubSpot app into hotglue, or you may get a conection error. You can access this from the Auth tab of your HubSpot app settings as pictured below.

That's it!

Supported Data

The Hubspot tap currently supports the following objects:

NameDescription
account
associations_deals_companiesThere are standard CRM objects: contacts, companies, deals, and tickets. If your account has an Enterprise subscription, you can also create custom objects. To keep track of the relationships between these objects, you can associate their records together.
associations_deals_contactsThere are standard CRM objects: contacts, companies, deals, and tickets. If your account has an Enterprise subscription, you can also create custom objects. To keep track of the relationships between these objects, you can associate their records together.
associations_deals_line_itemsThere are standard CRM objects: contacts, companies, deals, and tickets. If your account has an Enterprise subscription, you can also create custom objects. To keep track of the relationships between these objects, you can associate their records together.
callsYou can make calls directly to contacts from their record in HubSpot using a HubSpot provided phone number, an outbound phone number registered for calling, or a third-party calling provider.
companies
contact_events
contact_list
contact_list_data
contacts
contacts_all_ids
contacts_deleted
dealsIf your account has a Sales Hub Starter, Professional or Enterprise account, you can use multiple deal pipelines to align with your sales process.
emails
owners
subscription_changes
workflowsBy default, objects are only enrolled in workflows the first time they meet the workflow enrollment triggers or are enrolled manually. Add re-enrollment triggers to allow objects to be re-enrolled in your workflows when they meet your enrollment triggers again.

Don't see something you're looking for? Let us know

You can always edit the data you're pulling from the Hubspot connector in the field map settings: