Hubspot API Integration Profile
Information and guides about integrating with Hubspot API
Add Hubspot Integration to Your AppTo 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 to the Contacts object
- conversations.read -> add this one only if you're planning to set up and track changes and creation of new messages and conversations
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
- from the Hubspot developers console, go to the Webhooks section of the app you're using
- 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
- 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