> ## Documentation Index
> Fetch the complete documentation index at: https://control-dev.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect HubSpot

> Create a private app access token for Control.

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

| HubSpot scope | Data read by Control |
| - | - |
| `crm.objects.companies.read` | Companies |
| `crm.objects.contacts.read` | Contacts |
| `crm.objects.deals.read` | Deals and deal pipelines |
| `crm.objects.line_items.read` | Deal line items |
| `crm.objects.quotes.read` | Quotes |
| `tickets` | Tickets and ticket pipelines |
| `crm.objects.owners.read` | Owners |

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 [**Entities & sources**](https://app.control.dev/entities-data-sources/overview).
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

* [HubSpot private app authentication](https://developers.hubspot.com/docs/apps/legacy-apps/authentication/intro-to-auth)
* [HubSpot scope reference](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/scopes)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.