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

# HubSpot

> Sync Wave contacts into HubSpot CRM in real time

<Info>
  Available on the **Pro**, **Teams**, and **Enterprise** plans.
</Info>

The HubSpot integration automatically syncs contacts you collect through Wave into your HubSpot CRM as Contacts. When a contact is created, updated, or deleted in Wave, HubSpot is updated in real time, with no manual imports required. Contact notes are kept in sync as linked HubSpot Notes.

## How to Connect

<Steps>
  <Step title="Open the integration">
    Go to **Integrations → HubSpot**.
  </Step>

  <Step title="Enable auto-sync (optional)">
    Turn on **Auto-sync** to import all existing Wave contacts into HubSpot immediately.
  </Step>

  <Step title="Connect HubSpot">
    Click **Connect** and sign in to your HubSpot account.
  </Step>
</Steps>

Wave requests permission to read and write CRM contacts, read your contact schema (to create custom properties), and read HubSpot owners (to assign contacts).

## What Gets Synced

| Wave field           | HubSpot field                    |
| -------------------- | -------------------------------- |
| First name           | `firstname`                      |
| Last name            | `lastname`                       |
| Primary email        | `email`                          |
| Primary phone        | `phone`                          |
| Company              | `company`                        |
| Job title            | `jobtitle`                       |
| City                 | `city`                           |
| Language             | `hs_language`                    |
| Profile URL          | `website`                        |
| Contact note         | Linked HubSpot Note              |
| Assigned team member | HubSpot owner (matched by email) |

**Sync direction**: Wave → HubSpot (outbound only)

**When it syncs**: Real-time on contact create, update, or delete

## Features

* **Auto-sync on connect**: import all existing Wave contacts into HubSpot when you first connect.
* **Deduplication**: if a contact with the same primary email already exists in HubSpot, Wave updates it instead of creating a duplicate.
* **Note sync**: contact notes written in Wave are created or updated as linked HubSpot Notes.
* **Owner assignment**: contacts are automatically assigned to the matching HubSpot owner based on email address.

## Limitations & Requirements

* If your HubSpot plan has reached its contact limit, new contacts will not be synced.
* Owner matching is done by email. If a team member's email doesn't match any HubSpot owner, the contact is created without an owner.
* Two hidden custom properties (`wave_sync_id`, `wave_note_id`) are created in your HubSpot account during setup. They are used for deduplication and should not be deleted.

## Disconnecting

Go to **Integrations → HubSpot** and click **Disconnect**. This removes the integration and revokes Wave's access to your HubSpot account. Contacts that were already synced remain in HubSpot.