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

# HubSpot Integration

> Connect HubSpot CRM and configure how data flows between First Touch and your portal.

The HubSpot integration is managed from **Team Settings > Integrations** (at `/team-settings/integrations`). You need **Admin** permissions in First Touch to connect or disconnect the account.

<Note>
  Email account connections and sending schedule configuration are separate per-user settings. See [User Accounts](/WebApp/Settings/user-accounts) and [Sending Schedule](/WebApp/Settings/sending-schedule).
</Note>

***

## Connecting HubSpot

<Steps>
  <Step icon="map-location-dot" title="Navigate to Integrations">
    In the First Touch sidebar, click **Team Settings**, then select the **Integrations** tab.
  </Step>

  <Step icon="lock-keyhole" title="Authorize the connection">
    Locate the **HubSpot** card and click **Connect**.

    You will be redirected to HubSpot. Select the portal you want to connect, review the requested permissions, and click **Connect app** to grant access.
  </Step>

  <Step icon="check-double" title="Verify">
    After authorizing, you are redirected back to First Touch. The HubSpot card shows a green **Connected** badge.

    If you see a red **Reconnecting** badge, click **Connect** again and re-authorize.
  </Step>

  <Step icon="sliders" title="Configure settings">
    Click **Settings** on the connected HubSpot card to open the configuration view.
  </Step>
</Steps>

***

## HubSpot Settings

Once connected, the settings view exposes the following sections.

### Account Ownership

Controls what First Touch does when a prospect is already owned by a HubSpot user who is not on your team.

| Option                                        | Behaviour                                                                           |
| --------------------------------------------- | ----------------------------------------------------------------------------------- |
| **Assign ownership to available team member** | Allows First Touch to continue by assigning the record to an available team member. |
| **Don't reach out**                           | Prevents outreach when the HubSpot owner is outside your team.                      |

### Engagement Tracking

Toggles that control whether LinkedIn activities performed through First Touch are automatically logged to the HubSpot contact timeline.

**Connections**

* Request with note sent
* Connection accepted

**Messages**

* LinkedIn message sent
* LinkedIn message reply received

Each toggle saves immediately when changed.

### Company Field Mapping

Maps First Touch company fields to the corresponding HubSpot Company properties. Expand the section to view and modify individual field mappings.

Some rows are locked because First Touch uses them for company matching and record updates.

### Contact Field Mapping

Maps First Touch contact fields to the corresponding HubSpot Contact properties. Expand the section to view and modify individual field mappings.

Some rows are locked because First Touch uses them for contact matching and record updates.

***

## Disconnecting HubSpot

Inside the HubSpot settings view, click **Disconnect** on the account card and confirm. This stops all active syncing from First Touch.

To fully remove the app from your HubSpot portal, go to **HubSpot Settings > Integrations > Connected Apps**, find **First Touch**, click **Actions**, and select **Uninstall**.

<Warning>
  Uninstalling removes the First Touch app from HubSpot and stops workflow actions and data syncing. Historical activity logged to contact timelines is preserved.
</Warning>

***

## What the Integration Enables

Once connected, HubSpot powers several First Touch features across the product.

<CardGroup cols={2}>
  <Card color="#3c5d29" icon="timeline" title="Engagement Sync">
    Email, LinkedIn connection, and LinkedIn message activity performed in First Touch is automatically logged to the HubSpot contact timeline.
  </Card>

  <Card color="#3c5d29" icon="bolt" title="Workflow Triggers">
    Use HubSpot Workflows to automatically enroll contacts into First Touch flows. Some teams also install additional First Touch custom workflow actions for LinkedIn profile views and connection requests. See [Workflow Actions](/WebApp/HubSpot/Workflow-Actions).
  </Card>

  <Card color="#3c5d29" icon="database" title="Field Enrichment">
    First Touch maps and updates Contact and Company fields in HubSpot based on the field mappings you configure.
  </Card>

  <Card color="#3c5d29" icon="users-viewfinder" title="Audience Sync">
    Import HubSpot contact lists directly into First Touch Audiences for bulk enrollment into flows.
  </Card>
</CardGroup>