HubSpot Integration Development Guide

To be able to use your custom Hubspot connector parameters, you need to create a developer account and OAuth application in Hubspot. Follow these steps:

Get a Hubspot Developer Account

Developer account gives you access to Developer Hub which allows you to:

• Perform testing in a risk-free environment
• Build and develop an integration with Hubspot
• Update, maintain or delete your app

Sign up for a Hubspot developer sandbox account here

Build your OAuth Application

Hubspot has a great guide on how to build your app here

If you want your app to be accessible to other users outside of your organization, you may want to create a public app and submit it for listing. You can find more information about the process here.

Make sure you add the https://api.integration.app/oauth-callback as the Redirect URL in your application settings.

You should make sure that access scopes selected in the connector configuration fully match scopes selected in your app settings. If no scopes parameter provided, the following scopes are used:

• oauth
• crm.objects.contacts.read -> this one is also responsible for the webhook events subscription

NOTE: If scopes in your app config do not match the scopes in the connector configuration - you will see an error saying ”Couldn’t complete the connection Insufficient scopes were provided. Please contact the app developer”.

Use your OAuth Application

To connect to Hubspot, you'll need to provide your Client ID and Client Secret as the connector parameters. You can find them in your app settings.