# HubSpot

Connect HubSpot so managers can build a practice persona from a deal,
with the deal's real context.

> [!NOTE]
> Early access: ask your Chambr contact to enable it for your account.

| | |
|---|---|
| Status | **Native · Early access** |
| Direction | HubSpot → Chambr (read only) |
| Set up by | A Chambr manager, signing in to HubSpot |
| Time | About 2 minutes |
| Data freshness | Read live when a manager picks a deal |

## What you need

- A Chambr manager (on the Integrations page, or from New persona). Managers pick deals once
  it's connected.
- A HubSpot user who can install apps in your HubSpot account and read the
  deals, companies and contacts managers will use.
- Early access turned on for your Chambr account.

## What Chambr reads

| HubSpot | Used for |
|---|---|
| Deals: name, stage, amount, description, closed-lost reason, owner | Choosing a deal, the persona's situation and objections |
| The deal's company: name, industry, size, description | The persona's company |
| The deal's primary contact: job title | The persona's role and seniority |

Chambr reads only when a manager picks a deal, and never writes to HubSpot.

## Permissions and scopes

| Scope | Why Chambr needs it |
|---|---|
| `crm.objects.deals.read` | List and read deals |
| `crm.objects.companies.read` | Read the deal's company |
| `crm.objects.contacts.read` | Read the deal's contacts |

## Set it up

### 1. Open Integrations in Chambr

In Chambr, open **Integrations** in the left nav and find **HubSpot** under
CRM.

Managers can also connect from **Personas**: **New persona**, then
**Generate with AI**, then **From your CRM**.

### 2. Connect

Select **Connect**. HubSpot asks you to choose an account and approve
Chambr's access. Approve it.

### 3. Back in Chambr

You return to the Integrations page and the HubSpot card shows
**Connected**.

## Verify it works

1. Go to **Personas**, select **New persona**, then **Generate with AI**, then
   **From your CRM**.
2. If both CRMs are connected, pick **HubSpot**. Your deals are listed.
3. Pick one. Chambr drafts a persona from it for you to review.

## Limitations

- Chambr reads standard fields. Ask your Chambr contact about adding a custom field to the persona's context.
- The persona is written once from the deal; it doesn't change when the deal
  does.

## Troubleshooting

| Symptom | Cause | Fix |
|---|---|---|
| The card shows **Early access** and **Request access** | Not turned on for your account | Ask your Chambr contact |
| HubSpot won't let you approve | You can't install apps in that HubSpot account | Ask a HubSpot super admin to connect |
| The card says **Needs attention** | The app was uninstalled in HubSpot | Disconnect, then connect again |

## Disconnect

On the **Integrations** page, select **Disconnect** on the HubSpot card and
confirm. Chambr deletes its stored access; personas you already created stay.
To also remove Chambr on the HubSpot side, uninstall it from your HubSpot
account's **Connected apps**.
