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

# Connect HubSpot

> Connect HubSpot to import your contacts into Path as a channel of people, then manage status, reconnect, and disconnect.

Connecting HubSpot lets Path import your HubSpot contacts as people, grouped into a channel that represents your HubSpot portal. Authorize access once, then import with a single click.

<Note>
  **Before you start**

  * A HubSpot account.
  * A TalkValue workspace with an active Pro plan or trial. See [Plans and trial](/administration/billing/plans-trial-pro).
  * Workspace **Admin** role. Only admins can connect integrations. See [Members](/administration/workspace/members) if you need access.
</Note>

## Connection model

* **One HubSpot account per workspace.** To switch accounts, disconnect the current one and connect the new one.
* **Admin-only.** Only workspace [Admins](/administration/workspace/roles-and-permissions) can connect, reconnect, or disconnect integrations.
* **Workspace-scoped.** The connection belongs to the workspace, not to the Admin who connected it.

The authorization flow hands you off to HubSpot, asks you to grant TalkValue access, and redirects back. What TalkValue receives:

* **Read access to your contacts**: the fields TalkValue maps onto a person.
* **Account email**: shown on the integration card so you can confirm which account is connected.

TalkValue cannot post or edit anything in your HubSpot account.

## Connect

<Steps>
  <Step title="Open Settings → Integrations">
    Sign in at [app.trytalkvalue.com](https://app.trytalkvalue.com), open the side panel, and navigate to **Settings → Integrations**. You'll see a card for each supported provider, including HubSpot.
  </Step>

  <Step title="Click Connect on the HubSpot card">
    Click the **Connect** button on the HubSpot card. TalkValue opens an authorization flow that hands off to HubSpot.
  </Step>

  <Step title="Authorize TalkValue in HubSpot">
    Sign in to HubSpot if prompted, then grant TalkValue read access and approve. HubSpot redirects you back to TalkValue automatically.
  </Step>

  <Step title="Confirm the connection">
    Back in **Settings → Integrations**, the HubSpot card now shows a green **Connected** badge with the HubSpot account email and the connection date. You're ready to import.
  </Step>

  <Step title="Import your HubSpot portal into Path">
    Open **Path → Channels** and click **Import Channel**. In the dialog, pick **HubSpot** and click **Import**. TalkValue confirms that the import has started, and the new channel appears in your Channels list.
  </Step>
</Steps>

## What syncs

When you import HubSpot into Path, TalkValue brings in:

* Your **HubSpot portal** as a channel. The channel name is your HubSpot portal name.
* Your **contacts** as people, with these fields:

| HubSpot contact | TalkValue person     |
| --------------- | -------------------- |
| Email           | Email (identity key) |
| First name      | First name           |
| Last name       | Last name            |
| Phone           | Phone                |
| Job title       | Job title            |
| Company         | Company              |
| Profile photo   | Avatar               |

People are matched by **Email** within your workspace. Re-importing the same portal updates existing people in place and adds new ones. Nothing is duplicated. TalkValue also groups people into companies automatically by email domain.

## Status states

The HubSpot card on **Settings → Integrations** is in one of three states:

* **Not connected.** The card shows a **Connect** button. Click it to start the authorization flow.
* **Connected.** A green **Connected** badge appears in the top right, with the HubSpot account email and connection date underneath. The card has an external link to HubSpot and a **Disconnect** button.
* **Reconnect required.** An amber **Reconnect required** badge replaces the green one. The card description reads: *"Authentication expired or revoked. Connect a new HubSpot account above, then remove this entry."* This state appears when HubSpot invalidates or revokes access.

## Reconnect

When the card shows **Reconnect required**, TalkValue keeps the disconnected entry visible so you can finish the cleanup deliberately. Click **Connect** on the connectable HubSpot card above the disconnected one, run through the HubSpot authorization again, then click **Remove** on the disconnected entry once the new connection is in place. People and channels you already imported stay in your workspace through the disconnect.

## Disconnect

On the connected HubSpot card, click **Disconnect** and confirm. Already-imported data stays in your workspace. New contacts won't sync until you reconnect by clicking **Connect** again.

## Troubleshooting

### The HubSpot card shows "Reconnect required"

Authentication expired or was revoked from the HubSpot side. Connect a new HubSpot account on the card above, then remove the old entry. See [Reconnect](#reconnect) for the full pattern.

### Some contacts are missing from the import

Each contact needs an email, since Email is the identity key. Add an email to the contact in HubSpot, then re-sync. Archived contacts are excluded.

## Related

* [HubSpot field mapping](/platform/integrations/hubspot-fields). The full contact-to-person field reference.
* [Connect Slack](/platform/integrations/slack). The other channel-import provider for Path.
* [Channels](/path/manage/channels). Where imported channels appear and how to re-sync them.
* [Import a CSV](/path/import/csv-quickstart). The manual import path.