Skip to main content
Control connects to a HubSpot account with a private app access token.

​
Create a private app

  1. Sign in to the intended HubSpot account.
  2. Open Settings.
  3. Go to Integrations → Private Apps or the equivalent Development → Legacy Apps area shown for your account.
  4. Create a private app and give it a recognizable name such as Control.
  5. Grant the read scopes listed below.
  6. Create the app and copy its access token.
HubSpot is evolving its developer navigation. Existing legacy private apps remain supported; follow the provider’s current UI if labels differ.

​
Scopes required

Only add sensitive-data variants if Control must import properties that HubSpot classifies as sensitive. The standard connector does not require write scopes.

​
Connect in Control

  1. Open the HubSpot data source in .
  2. Paste the access token into the credential field.
  3. Save and verify the credentials.

​
Data imported

  • Companies, contacts, and deals
  • Deal line items and quotes
  • Tickets, deal and ticket pipelines, and owners
  • Associations between supported HubSpot objects
  • Configured standard and custom properties for the supported objects

​
Security

  • Grant only the read scopes needed by the connected data.
  • Never put the token in source control or screenshots.
  • Rotate the token if it is exposed or if the owning user’s access changes.
  • Update Control immediately after rotating the token.

​
Provider documentation