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

# HubSpot

> Connect HubSpot as your system of record so Deal Brain keeps deal context and CRM data reconciled.

Deal Brain connects to HubSpot as your system of record. Once connected, deals, companies, and contacts sync into Deal Brain, and every call, email, and decision your team makes gets tied back to the deal it belongs to.

HubSpot connects once for your whole organization. An **org admin** authorizes the connection, and everyone in the organization works from it — individual users don't connect their own HubSpot accounts.

<Note>
  Not using HubSpot? Deal Brain also connects to [Salesforce](/integrations/salesforce), or you can [import a CSV](/integrations/csv-import) of your opportunities.
</Note>

## Connecting HubSpot

An org admin connects HubSpot from the [Connections page](https://findtempo.co/app/settings/connections) in Deal Brain settings. Click **Connect** next to HubSpot and authorize access to your HubSpot account.

## What syncs

Deal Brain reads your HubSpot object and property definitions, then syncs the records your team works:

| HubSpot object | Becomes     |
| -------------- | ----------- |
| Deal           | Opportunity |
| Company        | Account     |
| Contact        | Contact     |

Your properties come across with HubSpot's naming, so filters and field references use keys like `dealtype`, `lifecyclestage`, and `jobtitle`. See [Fields and CRM objects](/admin/fields) for how to inspect what's tracked, and [agent filters](/agents/reference) for using them in automation.

## What Deal Brain can access

Deal Brain requests the following access to your HubSpot account:

| Access                                        | What it covers                                         |
| --------------------------------------------- | ------------------------------------------------------ |
| Read and write deals, companies, and contacts | Sync those records and update properties on them       |
| Read your object and property schema          | Discover which properties exist and which are writable |
| Read owners                                   | Match HubSpot record owners to people on your team     |
| Read sales email (optional)                   | Associate logged sales email with the right deal       |

Sales email access is optional. The rest is required for the integration to function.

### What Deal Brain does with this access

* Query and sync property definitions for deals, companies, and contacts
* Sync the deals your team selects during onboarding, plus their related companies and contacts
* Associate calls, emails, meetings, and documents with the right deal
* Update properties on existing HubSpot records, with citations back to the source artifact

## How writes to HubSpot work

Deal Brain updates existing HubSpot records. It does not create new deals, companies, or contacts in HubSpot — that's true in every update mode.

Whether an update reaches HubSpot automatically depends on the update mode set on each field:

| Update mode   | What Deal Brain does                                                                               |
| ------------- | -------------------------------------------------------------------------------------------------- |
| **Manual**    | Generates no proposals for the field. Nothing is written automatically.                            |
| **Suggest**   | Generates a proposal and holds it for human review. Nothing is written until a person approves it. |
| **Automatic** | Approves the update itself and writes it to HubSpot. No human reviews it first.                    |

<Warning>
  Fields set to **Automatic** are written to HubSpot with no human in the loop. Check which of your fields use **Automatic** before you describe Deal Brain's write behavior in a security or governance review. See [Fields and CRM objects](/admin/fields) for how update modes are set and who can change them.
</Warning>

## Not ready to connect?

If you can't get HubSpot connected yet, you can [import a CSV of your deals](/integrations/csv-import) and connect HubSpot later without losing anything.