How to get your HubSpot developer key and OAuth 2 credentials

September 26, 2024

This guide will show you how to retrieve your OAuth 2 credentials and developer API key in HubSpot.

Note: HubSpot allows you to create different types of apps - public and private. This guide is about public apps.

Register a HubSpot Developer Account

First, you'll need to register for a free account on HubSpot if you haven't already.

1. Navigate to the HubSpot Developers portal.
2. Click Create App Developer Account.
3. Follow the onboarding to complete your account setup.

Get your HubSpot Developer API key

Developer account API keys are separate from standard API keys - they can be used to manage subscriptions for webhooks and other HubSpot features.

1. Inside the HubSpot developer dashboard, open the sidebar and click Apps.
2. Click Get HubSpot API key.
3. Follow the instructions to create a Developer API key.
4. Click Show key to reveal your key. You will need this for the final step.

Create a HubSpot app

A HubSpot app is a container for your integration settings and is where you'll create and find your OAuth 2 credentials.

1. On the Apps page, click Create App.
2. Give your app a name and description.
3. Click on the Auth tab.
4. Under Redirect URLs, enter: https://api.unified.to/oauth/code
   
5. Under Scopes, click Add new scopes and select the permissions that your application will require. For example, if your application reads Deals, then select crm.deal.read
   
6. Click Create app to finish setting up your app.

(optional) Add the oauth scope to your app

For apps created before April 2024, the oauth scope may be missing from your app's auth settings. Apps created after this date have it on by default. This scope is required for the HubSpot integration to work.

1. Under Scopes, click Add new scope.
2. Search for oauth and select it.
3. Click Update.

Get your OAuth 2 credentials

1. After creating your app, you will be redirected to the App Info tab. Click again on the Auth tab.
2. Your unique Client ID and Client secret will be displayed. You will need these for the next step.
   

Activate the HubSpot integration in Unified.to with your client ID and secret

1. Open a new tab and navigate to the HubSpot integration in Unified.to
2. You will need the following three pieces of information from the earlier steps:
   1. Client ID
   2. Client secret
   3. Developer API key from the developer dashboard
3. Copy and paste these values into their respective fields on the page. Make sure that Your OAuth 2 credentials is selected above.
   

See also

• How to set up your scopes in HubSpot
• How to configure webhooks in HubSpot