Migrate your HubSpot Owner v2 API to v3 API

HubSpot is deprecating the Owner v2 API endpoints and the support for these endpoints will end on August 30, 2024. Hence, it is recommended that all the HubSpot administrators should migrate the existing Owner v2 API with the Owner v3 API by August 15, 2024.

This article explains how to find deprecating endpoints in your existing flows and replace them with new endpoints.

Additional references: Migrate to the Owners v3 API

Changes to make in the Celigo platform

A. Find v2 endpoints in the existing flows

To find each export that uses a HubSpot connection:

1. Sign in to your integrator.io account.

2. Navigate to Resources > Connections.

3. Search for an existing HubSpot connection, from Actions, and select Used by. A list of all items that use this connection appears.

4. Right-click the first flow step in the list and select your browser’s option to open it in a new tab.

5. Review the configuration for any of the v2 endpoints listed in the above table:

When you encounter a v2 endpoint, first copy the path parameter and search parameter values to a reference document to back them up when replacing the endpoints.

B. Update flows to use replacement v3 endpoints

For each export containing a v2 endpoint, replace it with the v3 endpoint by referring to the HubSpot v2 endpoints with v3 replacement endpoints section and update the flow by mapping with respective endpoints.

Example of replacing a deprecating export operation

Find each export of the flows that use a HubSpot connection; if it has the endpoint marked [Deprecating] follow the steps and update accordingly:

If the existing export is configured as follows:

• API version: v1

• API name: Owners API [Deprecating]

• API endpoint: Get an owner by ID [Deprecating]

Then, convert it according to the above table, as follows, and as shown in the image below:

• API version: v3

• API name: CRM API: Owners

• API endpoint: Read an owner by given ID or user ID