> ## Documentation Index
> Fetch the complete documentation index at: https://slatehq.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot

> Connect HubSpot as your workspace CRM so Slate can answer questions about your contacts, companies, deals, and pipeline in Cowork.

The HubSpot integration fills the **CRM** slot in Slate. Slate keeps a read-only synced copy of your HubSpot companies, contacts, and deals. In [Cowork](/docs/agents/cowork/overview), Slate reads that copy to answer questions about accounts, deals, and your pipeline.

## Why connect HubSpot to Slate?

Account research and pipeline questions go faster when Slate can see your CRM. Instead of exporting reports, ask Slate about a company or a deal and get an answer grounded in your HubSpot data.

## Prerequisites

* The **Admin** role in your Slate workspace. Members can view integrations but can't connect or manage them.
* A HubSpot account you can sign in to and approve access for

## What Slate syncs

| Record | What Slate reads |
| - | - |
| **Companies** | Name, domain, and activity dates |
| **Contacts** | Name, email, lifecycle stage, owner, company, and source fields |
| **Deals** | Name, pipeline, stage, amount, close date, owner, and stage history |

<Note>Slate requests read-only access to HubSpot. Slate never creates or changes records in HubSpot.</Note>

After the first import, Slate updates the copy from HubSpot change events and rechecks HubSpot every 15 minutes. The number of records Slate syncs depends on your Slate plan. When a plan limit applies, Slate keeps the most recently active records.

## Setup

### Step 1: Connect HubSpot

1. In Slate, open **Workspace settings → Integrations**.
2. Under **Essentials**, find the **CRM** row and click **Connect**.
3. In **Connect HubSpot**, optionally enter a **Connection name**.
4. Click **Continue to HubSpot**. HubSpot opens in a new window.
5. Sign in to HubSpot and approve access.
6. Back in Slate, the **CRM** row shows **Connected** and "HubSpot".

The **CRM** slot holds one CRM at a time. Slate starts importing your records as soon as the connection is ready.

### Step 2: Check the sync

1. Click **Manage** on the **CRM** row.
2. Review the connection details:
   * **Account** — your HubSpot account ID.
   * **Sync** — the import status (`pending`, `running`, `done`, or `failed`) and progress.
   * **Webhooks** — the status of live updates from HubSpot.
   * Record counts, such as "120 companies · 950 contacts · 40 deals".
3. If something went wrong, the dialog shows the last error in red.

## Using HubSpot data in Cowork

Ask Slate about your CRM in plain language:

```
Give me an account brief for acme.com before my call tomorrow.
```

```
Summarize our pipeline by stage for deals closing this quarter.
```

Slate can:

* Search contacts by name, email, company domain, or created date.
* Show a company with its contacts and its open and closed deals.
* Show one deal with its contacts and recent stage history.
* Summarize the pipeline by stage, with recent stage changes, filtered by pipeline or close date.
* Build an account brief for a company domain, with the company, its deals, and its contacts.

When a name matches more than one record, Slate lists the matches and asks which one you mean. Answers reflect the last sync, not a live HubSpot lookup.

## Managing the connection

### Reconnect HubSpot

1. Click **Manage** on the **CRM** row.
2. Click **Reconnect**. The **Connect HubSpot** dialog opens.
3. Sign in with the same HubSpot account and approve access.

Slate moves the existing CRM connection to the new sign-in. Your synced data stays in place.

<Note>Signing in with a different HubSpot account doesn't replace the connected one. To switch accounts, disconnect HubSpot first, then connect the new account.</Note>

### Disconnect HubSpot

1. Click **Manage** on the **CRM** row.
2. Click **Disconnect**. Slate shows a warning.
3. Click **Disconnect & delete** to confirm.

<Warning>Disconnecting removes CRM data from every Slate answer right away. The confirmation states that Slate permanently deletes the synced copy, including attribution history, after a 30-day grace period.</Warning>

## Troubleshooting

| Issue | Cause | Solution |
| - | - | - |
| "Sorry, we couldn't authenticate you" | Access wasn't approved in HubSpot | Start again from Step 1 and approve access |
| The HubSpot window doesn't open | Pop-ups are blocked | Allow pop-ups for Slate and try again |
| Slate says no CRM is connected | The **CRM** slot is empty | Connect HubSpot (Step 1) |
| **Sync** shows `failed` or an error appears | HubSpot access stopped working | [Reconnect HubSpot](#reconnect-hubspot) with the same account |
| Slate has fewer records than HubSpot | Your plan limits the number of synced records | Slate keeps the most recently active records within your plan's limit |
| A recent HubSpot change is missing | The change hasn't synced yet | Wait a few minutes. Slate rechecks HubSpot every 15 minutes. |

## What's next

* [Cowork](/docs/agents/cowork/overview) — ask Slate questions and run tasks
* [ClickUp](/docs/integrations/clickup) — connect project management for task sync
* [Slack](/docs/integrations/slack) — work with Slate from your Slack channels


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