# HubSpot (Cohort Sync)

Source: https://amplitude.com/docs/data/destination-catalog/hubspot-cohort-sync

---

On this page

- [Considerations](#considerations)
- [Set up the integration](#set-up-the-integration)
- [Send a cohort](#send-a-cohort)
- [Cohorts in HubSpot](#cohorts-in-hubspot)
- [Disconnect HubSpot from within Amplitude](#disconnect-hubspot-from-within-amplitude)
- [Uninstall Amplitude from a HubSpot account](#uninstall-amplitude-from-a-hubspot-account)
- [Troubleshooting](#troubleshooting)
- [User discrepancies between Amplitude and HubSpot](#user-discrepancies-between-amplitude-and-hubspot)

# HubSpot (Cohort Sync)

The HubSpot destination lets you sync an Amplitude-built cohort to your HubSpot contacts lists for targeting.

## Considerations

- This integration supports both Email and Contact ID as a `user_id` mapping option.
- If you choose Email as HubSpot's user ID, Amplitude creates a new email address contact in HubSpot when the user doesn't exist in HubSpot but does exist in the Amplitude cohort you're syncing.
- If you choose Contact ID as HubSpot's user ID, the contact must already exist in HubSpot in **long** data type format.

## Set up the integration

1. In Amplitude Data, navigate to *Catalog > Destinations*.
2. In the Cohort section, click *HubSpot*.
3. Log in to your HubSpot account through OAuth to authenticate. Then select the account that contains the cohort you want to sync.
4. After Amplitude redirects you to the Amplitude dashboard, select the identifiers to use for the cohort sync. Save your work.

## Send a cohort

1. In Amplitude, open the cohort you want to sync.
2. Click *Sync* and choose *HubSpot*.
3. Specify the HubSpot account to send the cohort to.
4. Set the sync cadence.
5. Save your work.

For scheduled cohort syncs, only the initial sync includes the full cohort. All later syncs include the additions and removals since the previous sync.

## Cohorts in HubSpot

After you send your Amplitude cohort to HubSpot, the cohort appears in the *Contacts* section of the HubSpot dashboard. Cohorts sent by Amplitude include an `amplitude_` prefix in the name.

HubSpot only ingests users for whom HubSpot has identifiers.

User A, User B, and User C are in the Amplitude cohort (Cohort 1). HubSpot only has identifiers for User A and User C. HubSpot creates a list that includes User A and User C, and drops User B.

## Disconnect HubSpot from within Amplitude

To disconnect HubSpot from within Amplitude, follow these steps:

1. In Amplitude, navigate to *Data > Sources > HubSpot*.
2. Click the trash can icon.
3. Follow the instructions in the confirmation modal that appears.
4. Click *Delete*.

After you disconnect HubSpot, Amplitude no longer processes new data sent from this source. Amplitude doesn't delete historical data from HubSpot, so you can still analyze it.

## Uninstall Amplitude from a HubSpot account

To uninstall Amplitude from your HubSpot account, follow these steps:

1. In HubSpot, navigate to *Reporting & Data > Integrations > Connected apps > Amplitude*.
2. Select *Uninstall* from the *Actions* dropdown.
4. Click *Uninstall*.

This doesn't delete any existing Amplitude data in HubSpot, but Amplitude no longer updates it.

## Troubleshooting

### User discrepancies between Amplitude and HubSpot

Some destinations like HubSpot may return a 2XX response indicating the cohort sync completed successfully from Amplitude. Sometimes the third-party destination silently drops users who don't meet their criteria and doesn't communicate the exclusion back to Amplitude. To check whether a user transferred successfully, review the CSV file from Amplitude. Amplitude analyzes response codes to identify cases where users aren't included at third-party platforms, but technical constraints may prevent full detection of every silent exclusion. If you encounter issues, refer to this [guide](https://help.amplitude.com/hc/en-us/articles/360060055531-Sync-to-third-party-destinations) for help investigating and diagnosing cohort sync discrepancies.

Was this helpful?

<!--$-->

<!--/$-->