HubSpot Migration Guide

Availability

Cloud Self-Managed Community Self-Managed Enterprise PyAirbyte

Support Level

Airbyte

Connector Version

5.6.0 (last updated 3 days ago)

CDK Version

6.48.14

Sync Success Rate

Usage Rate

Definition ID

36c891d9-4bd9-43ac-bad2-10e12756272c

Upgrading to 5.0.0

note

This change is only breaking if you are syncing streams Contact Lists, Contacts Form Submissions, Contacts List Memberships, or Contacts Merged Audit.

This update deprecates three contacts streams because Hubspot is deprecating V1 of their REST API and these streams make use of data from endpoints that no longer exist in their V3 API.

In addition, the certain schema fields of the Contact Lists stream will be added, removed, or modified due to changes in how Hubspot's V3 API in comparison to the V1 API being deprecated.

Users should:

• Refresh the source schema
• Remove the aforementioned streams from their connection.
• If applicable, users can enable the Form Submissions stream which provides similar functionality to Contacts Form Submissions.

Remove deprecated streams, refresh affected schemas, and reset data

1. Select Connections in the main nav bar.
   1. Select the connection affected by the update.
2. Select the Schema tab.
   1. Select Refresh source schema.
   2. Select OK.

note

Any detected schema changes will be listed for your review.

3. Select Save changes at the top right of the page.
   1. Ensure the Reset affected streams option is checked.

note

Depending on destination type you may not be prompted to reset your data.

4. Select Save connection.

note

This will reset the data in your destination and initiate a fresh sync.

For more information on resetting your data in Airbyte, see this page

Upgrading to 4.0.0

note

This change is only breaking if you are syncing streams Deals Property History or Companies Peoperty History.

This update brings extended schema with data type changes for the Marketing Emails stream.

Users should:

• Refresh the source schema for the Marketing Emails stream.
• Reset the stream after upgrading to ensure uninterrupted syncs.

Refresh affected schemas and reset data

1. Select Connections in the main nav bar.
   1. Select the connection affected by the update.
2. Select the Replication tab.
   1. Select Refresh source schema.
   2. Select OK.

note

Any detected schema changes will be listed for your review.

3. Select Save changes at the bottom of the page.
   1. Ensure the Reset affected streams option is checked.

note

Depending on destination type you may not be prompted to reset your data.

4. Select Save connection.

note

This will reset the data in your destination and initiate a fresh sync.

For more information on resetting your data in Airbyte, see this page

Upgrading to 3.0.0

note

This change is only breaking if you are syncing the Marketing Emails stream.

This update brings extended schema with data type changes for the Marketing Emails stream.

Users should:

• Refresh the source schema for the Marketing Emails stream.
• Reset the stream after upgrading to ensure uninterrupted syncs.

Refresh affected schemas and reset data

1. Select Connections in the main nav bar.
   1. Select the connection affected by the update.
2. Select the Replication tab.
   1. Select Refresh source schema.
   2. Select OK.

note

Any detected schema changes will be listed for your review.

3. Select Save changes at the bottom of the page.
   1. Ensure the Reset affected streams option is checked.

note

Depending on destination type you may not be prompted to reset your data.

4. Select Save connection.

note

This will reset the data in your destination and initiate a fresh sync.

For more information on resetting your data in Airbyte, see this page

Upgrading to 2.0.0

note

This change is only breaking if you are syncing the Property History stream.

With this update, you can now access historical property changes for Deals and Companies, in addition to Contacts. To facilitate this change, the Property History stream has been renamed to Contacts Property History (since it contained historical property changes from Contacts) and two new streams have been added: Deals Property History and Companies Property History.

This constitutes a breaking change as the Property History stream has been deprecated and replaced with the Contacts Property History. Please follow the instructions below to migrate to version 2.0.0:

1. Select Connections in the main navbar.
   1. Select the connection(s) affected by the update.
2. Select the Replication tab.
   1. Select Refresh source schema.

note

Any detected schema changes will be listed for your review. Select OK to proceed.

3. Select Save changes at the bottom of the page.
   1. Ensure the Reset affected streams option is checked.

note

Depending on destination type you may not be prompted to reset your data

4. Select Save connection.

note

This will reset the data in your destination and initiate a fresh sync.

For more information on resetting your data in Airbyte, see this page.