# HubSpot
URL: /reference/integrations/hubspot
Type: reference
Description: Sync contacts, deals, and tickets with your CRM.
Keywords: hubspot, integration, api key, connect
Sync contacts, deals, and tickets with your CRM.

Connect [#connect]

Connect HubSpot with an API key in **Settings → Integrations**. Open the HubSpot card, click **Connect**, and provide:

| Field       | Required | Notes                                                                                                                                                               |
| ----------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Service Key | Yes      | Create it in HubSpot under Settings → Integrations → Service Keys. A private app access token also works; a personal access key (used by the HubSpot CLI) will not. |

See [HubSpot's own instructions](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/account-service-keys) for creating this credential.

Required scopes [#required-scopes]

Grant these to look up customer records in the Assist sidebar:

| Scope                        | Needed for                                       |
| ---------------------------- | ------------------------------------------------ |
| `crm.objects.contacts.read`  | Customer lookup, Get Contacts, Search Contacts   |
| `crm.objects.companies.read` | Customer lookup, Get Companies, Search Companies |

Add these only for the Workflow Builder blocks you actually use:

| Scope                         | Needed for                                               |
| ----------------------------- | -------------------------------------------------------- |
| `crm.objects.contacts.write`  | Create Contact, Update Contact                           |
| `crm.objects.companies.write` | Create Company, Update Company                           |
| `crm.objects.deals.read`      | Get Deals                                                |
| `crm.objects.owners.read`     | Get Users                                                |
| `tickets`                     | Get Ticket, Search Tickets, Create Ticket, Update Ticket |

Supported actions and triggers [#supported-actions-and-triggers]

Actions [#actions]

| Block                                | What it does                                                     |
| ------------------------------------ | ---------------------------------------------------------------- |
| [HubSpot](/reference/blocks/hubspot) | Work with HubSpot contacts, companies, deals, tickets, and users |

Limits and failure modes [#limits-and-failure-modes]

* The connection can expire or be revoked. When it does, HubSpot blocks fail with an authorization error until you reconnect in **Settings → Integrations**.
* A disconnected or unconfigured integration makes its blocks unavailable in the Workflow Builder.

{/* TODO(docs): document HubSpot-specific rate limits and permission errors — not encoded in @stylo/core. */}

Related [#related]

* [Integrations overview](/integrations)
* [All workflow blocks](/reference/blocks)
* [Troubleshooting](/troubleshooting)