> ## Documentation Index
> Fetch the complete documentation index at: https://docs.attention.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Integrate Attention with HubSpot
> Connect your HubSpot account to enable 2-way sync with Attention
You must be an Attention Admin to be able to manage CRM integrations, including HubSpot.
Likewise, you must be a HubSpot Super Admin — or a user with **App Marketplace Access** permissions — to be able to connect Attention to your HubSpot account.
# What the integration does
Attention is an AI platform for revenue teams: it records and analyzes sales calls, scores them, and turns conversations into structured CRM data. Connecting HubSpot enables a 2-way sync:
* **HubSpot → Attention**: Attention syncs your deals, companies, contacts, leads, owners, and pipelines so calls are automatically matched to the right records, and so deal boards and forecasting reflect live CRM data.
* **Attention → HubSpot**: Attention writes AI-generated insights from your calls back to the HubSpot properties you choose — no manual data entry. Reps can also push updates manually, and Attention Builder workflows can create or update records (contacts, deals, companies, tickets) as automation steps.
Common use cases:
* Auto-populate deal and contact properties (next steps, pain points, competitors, MEDDIC fields) after every call.
* Keep forecasts and deal boards in Attention synchronized with HubSpot pipelines and stages.
* Filter and analyze calls in Attention by the HubSpot records they relate to.
# Connect HubSpot to Attention
CRM integrations are managed from the **CRM Settings** page, which brings the integration, field selection, AI field configurations, and CRM workflows together in one place.
1. Log into [Attention](https://app.attention.tech) as an Admin.
2. Click on your name on the top left corner.
3. Select **⚙️ Settings** from the dropdown.
4. In the **Settings** page, select **CRM Settings** on the left sidebar.
5. In the **CRM integration & sync** section, click **Add your CRM**.
6. Select **HubSpot** in the **Integrate your CRM** dialog.
7. A new window will open with an **Authorize HubSpot** step. Click **Continue** to be taken to HubSpot.
8. Log into HubSpot if prompted. If your login has access to more than one HubSpot account, select the account you want to connect and click **Choose Account**.
9. HubSpot will show the permissions Attention is requesting (see the scope list below). Review them and select **Connect app**.
10) The window closes and you are returned to Attention, where the HubSpot card now appears under **CRM integration & sync**, showing how many record types and fields are synced.
Once connected, Attention starts an initial sync of your HubSpot data. Deals, companies, contacts, leads, owners, and pipelines are synced with a default set of properties; depending on the size of your HubSpot account, the initial sync can take from a few minutes to a few hours. After that, changes in HubSpot are picked up continuously.
If you don't see **CRM Settings** in the sidebar, your Attention user doesn't have management access — ask an Attention Admin in your organization to connect the integration.
# Required HubSpot access scopes
Attention requests the following OAuth scopes. HubSpot displays this list on the approval screen during installation.
| Scope | Purpose |
| -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| `oauth` | Basic OAuth access — identifies the connected account and keeps the connection alive without re-authentication |
| `crm.objects.deals.read` / `crm.objects.deals.write` | Sync deals into Attention (deal boards, forecasting, call matching) and write AI-generated properties back to deals |
| `crm.objects.companies.read` / `crm.objects.companies.write` | Sync companies for account matching and write company properties back |
| `crm.objects.contacts.read` / `crm.objects.contacts.write` | Match call participants to contacts and create or update contacts from workflows |
| `crm.objects.leads.read` / `crm.objects.leads.write` | Sync leads for call matching and lead-based workflows |
| `crm.objects.owners.read` | Read owners so records and calls can be attributed to the right reps (matched by email) |
| `crm.objects.users.read` | Read user identifiers for reporting and attribution |
| `crm.objects.line_items.read` / `crm.objects.line_items.write` | Read and update line items on deals when workflows reference them |
| `crm.objects.custom.read` / `crm.objects.custom.write` | Sync custom objects for organizations that map Attention data to them |
| `crm.objects.listings.read` / `crm.objects.listings.write` | Support HubSpot industry objects (listings) for organizations that use them |
| `crm.objects.services.read` / `crm.objects.services.write` | Support HubSpot industry objects (services) for organizations that use them |
| `crm.extensions_calling_transcripts.write` | Attach call and transcript data through HubSpot's calling extension |
| `tickets` | Let Attention Builder workflows create and update support tickets |
Attention only reads the objects and properties enabled for your organization, and only writes the properties you explicitly map. Scopes define the maximum access HubSpot allows — not what Attention does by default.
# Configure the integration
Everything below lives on the same **Settings → CRM Settings** page:
1. **Choose synced record types and properties.** On the HubSpot card, click **Manage** (labelled **Select fields to sync** right after connecting). Attention enables a default set of properties per object (e.g. deal name, amount, close date, stage, owner); enable any additional properties you want available in deal boards, filters, and AI field mapping.
2) **Map AI-generated fields.** In the **CRM field configurations** section, follow [Create & Map CRM Fields](/workspace-setup/crm-config) to define the fields Attention should extract from calls and map each one to a HubSpot property. Pick-list values must match your HubSpot property options exactly.
3) **Pick a sync trigger.** In the **Connect Attention fields to CRM fields with workflows** section, add a workflow and choose **Conversation finish** to update HubSpot automatically after each call, or **User action → Update CRM** to let reps review and push updates manually from the call sidebar.
# Day-to-day usage
* **Automatic**: with a **Conversation finish** trigger, HubSpot properties update within minutes of a call ending — no rep action required. Deal boards and forecasts in Attention stay in sync with HubSpot as deals progress.
* **Manual**: reps click **Update CRM** in the call sidebar to review AI-suggested values before pushing them to HubSpot.
* **Workflows**: [Attention Builder](/builder-101/getting-started) workflows can read and write HubSpot records as action steps — for example, creating a follow-up ticket or updating a deal stage when a call meets certain criteria.
See [CRM Sync](/core-features/crm-sync) for how synced records appear throughout Attention.
# Disconnect or uninstall
## Disconnect from Attention
1. Go to **Settings → CRM Settings**.
2. On the HubSpot card under **CRM integration & sync**, open the card menu and select **Delete integration**.
3. Confirm in the **Delete integration** dialog. This action cannot be undone from the UI — reconnecting requires going through the OAuth flow again.
Disconnecting stops all syncing immediately — Attention no longer reads from or writes to your HubSpot account.
## Uninstall from HubSpot
You can also revoke access from the HubSpot side:
1. In HubSpot, go to **Settings → Integrations → Connected Apps**.
2. Find **Attention** and select **Uninstall**.
This revokes Attention's OAuth tokens; syncing stops immediately.
## What happens to your data
* **Data in HubSpot**: nothing is deleted. Properties Attention wrote to your records remain in HubSpot.
* **Data in Attention**: previously synced HubSpot records are retained so existing call associations and analytics keep working. To have synced HubSpot data deleted from Attention, contact [support@attention.com](mailto:support@attention.com).
* Reconnecting later re-runs the initial sync and resumes where you left off.
# Support
If the connection expires or stops syncing (for example, after the connecting user's HubSpot access changes), use **Reconnect** on the HubSpot card in **Settings → CRM Settings** to re-run the OAuth flow without losing your configuration.
For anything else, reach out to [support@attention.com](mailto:support@attention.com) or your Attention point of contact.