On this page

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.
  3. Follow the instructions in the confirmation modal that appears.
  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 for help investigating and diagnosing cohort sync discrepancies.

Was this helpful?