🔐 How to Generate an API Key for HubSpot Using a Legacy App
This integration allows LinkedNav to push leads and their data directly into your HubSpot 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 creating that Legacy App and retrieving the access token you'll need to connect LinkedNav 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
Go to https://app.hubspot.com and sign in with an account that has Admin rights for the portal you're working in.
2. Navigate to the Legacy Apps Section
- In the top-right corner, click on your profile icon.
- Go to "Profile & Preferences".
- 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, such as:
LinkedNav Integration
Add a short description if needed — this is just for your internal reference.
Under App Type, select "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 datacrm.objects.contacts.write→ to create or update contact datacrm.schemas.contacts.read→ to read contact properties and metadatasettings.users.read→ to get and select the users of the HubSpot accountcrm.objects.owners.read→ to get and select the owners of the HubSpot account
In the Scopes tab, click the checkbox for each scope above. You can use the search bar to find them quickly.
4. Create the App and Get the Token
- Click "Create app" at the top right corner of the screen.
- Once created, you'll be shown your Access Token — this is your API key for LinkedNav.
- Copy and store it somewhere safe — you won't be able to see it again after closing the screen.
🔗 Connect to LinkedNav
- In LinkedNav, go to Integrations in the sidebar.
- Click "Install this app" under HubSpot.
- Paste your access token into the HubSpot Legacy App Token field.
- Click Verify to confirm the token works.
- Toggle Automatically sync new contacts if you want contacts pushed in real time.
- Click Connect HubSpot.
