Skip to main content
HubSpot

​
Overview

​
Supported resources

​
Connect setup

HubSpot uses OAuth 2.0 with PKCE. You need a Public app created under Legacy apps in the HubSpot developer portal.
1

Create a HubSpot Public app

Go to HubSpot Developer Portal → Apps → Legacy apps → Create app. Select Public app. Under Auth, copy the Client ID and Client Secret.
2

Add the redirect URL

In your app’s Auth settings, add the following URL to the Redirect URLs list:
3

Configure required scopes

Enable the following scopes on your app:
  • crm.objects.contacts.read
  • crm.objects.contacts.write
  • crm.objects.deals.read
  • crm.objects.deals.write
  • crm.objects.leads.read
  • crm.objects.leads.write
  • crm.objects.companies.read
  • crm.objects.companies.write
  • crm.objects.owners.read
  • scheduler.meetings.meeting-link.read
4

Connect via the widget

When your end user opens the Connect widget, they will enter the Client ID and Client Secret, then be redirected to HubSpot to authorize the connection.

​
Usage

​
Notes

  • HubSpot deals and meetings include enriched contact and company associations automatically.
  • Owner names and emails are resolved via a secondary lookup on crm.objects.owners.
  • Use environment: "sandbox" in your connect token to route requests to the HubSpot sandbox account.