> For the complete documentation index, see [llms.txt](https://help.usejimo.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.usejimo.com/docs/integrations/hubspot.md).

# HubSpot

Sync HubSpot properties onto existing Jimo users in near real time, to build segments and target experiences on CRM data.

The HubSpot integration copies the HubSpot properties you choose onto your existing Jimo users. You then target experiences and build segments on CRM data, such as lifecycle stage or account owner.

## What it does

* **One way, HubSpot to Jimo.** Jimo reads HubSpot and never writes back to it.
* **Existing users only.** It updates users that already exist in Jimo and never creates users or records.
* **Near real time.** A change on a matched HubSpot record updates the user right away, and a daily job catches anything missed.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FgXIJkr3DBgdOrhn2u0ch%2FF2-54a-crm-flow-hubspot.png?alt=media&amp;token=4076cb76-3e95-40ba-a21f-6563b9378ecc" alt="HubSpot records are matched to existing Jimo users on email or your user ID; mapped fields become attributes with the HubSpot icon, in near real time. A record with no match is skipped, and nothing is written back to HubSpot"><figcaption></figcaption></figure>

## Before you start

* A HubSpot account you can sign in to.
* Users already identified in Jimo. See [Identify your users](https://help.usejimo.com/docs/getting-started/install-jimo/identify-your-users.md).
* A matching field present in both tools: email, or the user ID you send to Jimo stored as a HubSpot property.
* A Jimo role with access to the Integrations settings. See [Integration setup](https://help.usejimo.com/docs/integrations/integration-setup.md).

## Connect

{% stepper %}
{% step %}

### Enable HubSpot

In [Settings > Integrations](https://i.usejimo.com/settings/integrations), hover the HubSpot card and click **Enable** to open its setup page.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FnDcVvK3oKmQkHT9ahh1m%2Fimage.png?alt=media&amp;token=03688f2f-8dfc-4aba-bdca-7d165a35376d" alt="HubSpot card in Settings > Integrations"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Sign in to HubSpot

Connect with HubSpot and choose the account to sync from.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2Fj53PgGUhyvaWB7WSvHLm%2FCapture%20d%E2%80%99e%CC%81cran%202023-12-12%20a%CC%80%2011.19.39.png?alt=media&amp;token=af94c38d-e8cf-4451-9fce-63891dc4a7e3" alt="Choose the HubSpot account"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Choose the matching field

Pick the HubSpot field and the Jimo field that identify the same person. Email is the default. To use your Jimo user ID, make sure the same value is stored as a HubSpot property.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2Faao1gKbD5hWa3KxC9c6X%2Fimage.png?alt=media&amp;token=1cb4c87b-7466-47bb-9f9b-337a2158396a" alt="Matching field between HubSpot and Jimo"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Map the properties

For each HubSpot property you want in Jimo, select a Jimo attribute, or type a new name and press Enter to create it.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FrFSOWyFEoBdqECX02f8r%2Fimage.png?alt=media&amp;token=7c85bf9f-bcf9-4be2-92c3-225a631a236a" alt="Property mapping, HubSpot on the left, Jimo attribute on the right"><figcaption></figcaption></figure>

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2F7JVv6G4PW7badLlJpwnK%2Fimage.png?alt=media&amp;token=1c84ab2c-2190-4b48-956e-6277ac5a9ba3" alt="More property mappings"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Run a full sync

Run a full sync so the mapped attributes appear on your existing users.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2F0K9PIGPXyarOpXqivudo%2Fimage.png?alt=media&amp;token=a299971f-70d4-447f-8c2a-b5c51e6bb866" alt="Run full sync button"><figcaption></figcaption></figure>

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FVBwbAAhDfShoktNu6oup%2Fimage.png?alt=media&amp;token=da27acd7-a2f2-48ee-95c6-4ecb180ab386" alt="Full sync running on the HubSpot settings page"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## What flows into Jimo

| What                                   | When                                                  | Where you see it                         |
| -------------------------------------- | ----------------------------------------------------- | ---------------------------------------- |
| Mapped properties of matched records   | On create or update in HubSpot, then a daily catch-up | On the user profile, with a HubSpot icon |
| Past values of a newly mapped property | Only when you run a full sync                         | Same                                     |

Synced properties are attributes like any other: use them in [Who](https://help.usejimo.com/docs/publish/target-right-people-who.md) and in [segments](https://help.usejimo.com/docs/analyze/users-and-segments/audience/segments.md).

## Verify

Open a user you know is in HubSpot in [Users](https://help.usejimo.com/docs/analyze/users-and-segments/audience/users.md). The mapped properties show on the profile with the HubSpot icon. If they are empty, run a full sync, then check that the matching field has the same value in both tools.

## Limits

#### No write-back to HubSpot

Jimo does not create HubSpot contacts or update HubSpot properties. To push Jimo events to HubSpot, have your backend receive [webhooks](https://help.usejimo.com/docs/integrations/webhooks.md) and call the HubSpot API.

#### No automatic backfill

A property you add to the mapping fills only from the next change in HubSpot. Run a full sync to bring in past values.

#### Unmatched records are skipped

A HubSpot record with no matching Jimo user is ignored. Check that the matching field exists, with the same value, in both tools.

## Stop the integration

In [Settings > Integrations](https://i.usejimo.com/settings/integrations), open HubSpot and click the delete button. The property sync stops right away.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FPm4DVHF0XdiULv8lYsI9%2Fimage.png?alt=media&amp;token=dae2853a-b7d0-4d2d-8217-a9632849d6b9" alt="Delete the HubSpot integration"><figcaption></figcaption></figure>

## Related

* [Integration setup](https://help.usejimo.com/docs/integrations/integration-setup.md): the mapping pattern shared with Salesforce
* [Salesforce](https://help.usejimo.com/docs/integrations/salesforce.md)
* [Attributes](https://help.usejimo.com/docs/analyze/users-and-segments/data-management/attributes.md)
