HubSpot V3 connection

note

HubSpot V3 is currently in Beta.

The HubSpot V3 connector is a fully rebuilt source connector based on HubSpot's latest CRM API. It is separate from the existing HubSpot connector and must be configured independently.

Prerequisites

Before you create a HubSpot V3 connection, ensure you have the following:

• A HubSpot account with permissions to create and manage OAuth apps
• An OAuth2 app configured in HubSpot with the following credentials:
  • Client ID
  • Client Secret
  • Redirect URI
• The following OAuth2 scopes granted to your HubSpot app:
  • crm.objects.contacts.read
  • crm.objects.companies.read
  • crm.objects.deals.read
  • crm.objects.tickets.read
  • crm.objects.quotes.read
  • crm.lists.read
  • automation (required for Workflows)
  • forms (required for Forms)
  • crm.schemas.read (required for custom object resolution)

Procedure

1. Navigate to the Data Integration Console.
2. Click Connections from the left-hand menu.
3. Click + New Connection.
4. Find and select the HubSpot V3 connection.
5. Enter the Connection Name.
6. Enter the Client ID from your HubSpot OAuth app.
7. Enter the Client Secret from your HubSpot OAuth app.
8. Enter the Redirect URI registered in your HubSpot OAuth app.
   note

   The Redirect URI must match exactly what is configured in your HubSpot app settings. Any mismatch causes the authorization to fail.

9. Click Authorize. You are redirected to HubSpot's authorization page.
10. Sign in with your HubSpot account credentials and click Grant access.
11. Click Test Connection.

If your connection is successful, you can use it in Data Integration.