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

# HubSpot integration

> Native, two-way connection between ReachBoost and a HubSpot portal. Scope per campaign or per sender.

## Connect

**1. Open integrations**

**Integrations → Native integrations → HubSpot**, select **Connect**.

**2. Authorise in HubSpot**

Sign in to HubSpot in the window that opens, pick the portal to connect.

**3. Confirm**

Confirm the connection on the final screen.

## Configure

The configuration opens automatically after connect. To come back later, open the HubSpot connection → **Configure integration**.

### Details

* **Name** — label for this configuration.
* **Description** — optional internal note.
* **HubSpot owner** — the person assigned to leads that sync through this configuration.
* **Enrich on push** — refreshes lead data before it sends. Leave this on.
* **Events** — pick which ones trigger a sync. The list below.

### Scope

Limit the integration to a specific campaign, a specific LinkedIn account, or both. Only events inside that scope trigger a sync.

> [!TIP]
>
> Create **one integration per LinkedIn account**. That way each sync is attributed to the right HubSpot owner.

### Mapping

Connecting HubSpot adds three properties to each contact:

| Property | What it holds |
| - | - |
| `reachboost_lead_source` | Always `ReachBoost`. |
| `reachboost_status` | The lead's current stage (Not interested, Engaged, Interested, Hot lead, Meeting booked, Won, Lost). |
| `reachboost_tags` | The lead's tags, comma-separated. |

Notes are logged on the contact for each stage change, connection request event, follow-up, reply, and inbox message.

Decide whether to **update contact data on existing records**. Off by default — existing fields are left alone.

Save and select **Activate**.

## Which events can trigger a sync

| Campaign events | Lead status events |
| - | - |
| Connection request sent | Not interested |
| Connection request accepted | Engaged |
| Connection request withdrawn | Interested |
| Follow-up sent | Hot lead |
| Message replied | Meeting booked |
| | Won |
| | Lost |

## Manual sync

A specific lead right now: open the lead → **⋯** → **Sync to HubSpot**.

## Related

* [Integrations overview](https://docs.reachboost.io/help/integrations/overview.md)
* [Tag and classify leads](https://docs.reachboost.io/help/lead-lists/tag-leads.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.