HubSpot Integration Development Guide
Add white-label customer-facing integration with HubSpot into your app with just a few lines of code.
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.