Skip to main content

How to Integrate with Hubspot

šŸ” How to Generate an API Key for HubSpot API Using a Legacy App

This integration allows Gojiberry to push leads and their data into your Hubspot directly into your CRM under the relevant contact.
​

To make this possible, HubSpot requires a Legacy App with specific permissions (called scopes).
​
This tutorial will guide you through the process of creating that Private App and retrieving the API key (token) you’ll need to connect Gojiberry to your HubSpot account — securely and with the right level of access.


āœ… Why Use a Legacy App?

HubSpot no longer supports the older legacy API keys for security reasons. Legacy Apps are the new standard and provide:

  • Scoped access: Only the permissions your app needs.

  • Secure tokens: Safer than legacy API keys.

  • Better audit/logging: You can monitor access and usage.

🧭 Step-by-Step Tutorial

1. Log into HubSpot


2. Navigate to the "Legacy Apps" Section

  • In the top-right, click on your profile icon.

  • Go to ā€œAccount Settingsā€.

  • In the left sidebar, scroll down to ā€œIntegrationsā€ > ā€œLegacy Appsā€.

  • Click ā€œCreate a legacy appā€.


3. Configure Your Legacy App

3.1. App Name & Description

Give your app a meaningful name, like:

"My CRM Integration"
​

Add a short description if needed. This is just for internal use.

Put "Private App":

3.2. Assign the Correct Scopes (Permissions)

For contact-related operations, you must enable the following scopes:

  • crm.objects.contacts.read → to read contact data

  • crm.objects.contacts.write → to create or update contact data

  • crm.schemas.contacts.read → to read contact properties and metadata

  • crm.objects.deals.write → to link the contact to a deal

  • settings.users.read → to get and select the users of the Hubspot account

  • crm.objects.owners.read → to get and select the owners of the Hubspot account

In the Scopes tab:

  • Click the checkbox for each of the three scopes above.

  • You can use the search bar to find them quickly.


4. Create the App and Get the Token

  • Click ā€œCreate appā€ at the bottom of the screen.

  • Once created, you’ll be shown your Access Token (this is your new API key).

  • Copy and store it somewhere safe — you won’t be able to see it again.

Did this answer your question?