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 Required Scopes selected in your app settings. If no scopes parameter provided, only the oauth scope is used.

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”.

Configure the app parameters in the integration.app platform

• Add the Hubspot app from store in the Integration.app console
• Click Configure & Test
• In the Parameters section, select a Use custom parameters toggle / Edit Parameters
• Fill in Client Id and Client Secret
• Add scopes your application may require

Configure Webhooks

Hubspot offers a mechanism of subscription to changes that occur with user's content. To be able to receive events with these changes, you may want to create an application webhook like so:

• go to the integration.app console => External Apps => Hubspot => Configure & Test and copy the Global Webhooks url <img height="135" width="671" alt="global webhooks" src="https://static.integration.app/connectors/box/asset-b9816d39-61ff-4eb0-b51e-bf4f5f844ed6.png" />
• from the Hubspot developers console, go to the Webhooks section of the app you're using <img height="289" width="880" src="https://static.integration.app/connectors/hubspot/asset-40858dfd-bb5b-45cf-8559-2bdaafaee562.png" />
• paste the Global Webhooks url you saved earlier into the Target URL field
• click Create Subscription
• configure the webhook subscriptions as shown on the image below <img height="412" width="455" src="https://static.integration.app/connectors/hubspot/asset-da8c222f-55ee-49da-863e-cc356788d9fa.png" />
• If on this stage you see a Subscribing to these events requires the following scope: conversations.read - go ahead and click "Add this required scope" button (don't forget to save the app settings after!)
• press "Subscribe" in the bottom