Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.alterauth.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Connect your users to HubSpot for CRM data, contact management, deal tracking, and marketing automation.
PropertyValue
Provider IDhubspot
CategoryPopular
PKCESupported
Token refreshAutomatic
Redirect URIShown in Developer Portal

​
Step 1: Create a HubSpot OAuth App

1

Install and authenticate the HubSpot CLI

Install the HubSpot CLI (v7.6.0 or later) and authenticate with hs init or hs account auth. Apps are now created via the CLI from any standard HubSpot account — the legacy developer-account model was retired in March 2026.
2

Create a new project

Run hs project create and choose:
  • Distribution: Marketplace or restricted installation
  • Authentication: OAuth (for installation in multiple HubSpot accounts)
3

Configure OAuth settings

Edit the app’s top-level app-hsmeta.json file and add the Alter callback URL (from the Developer Portal) to the redirectUrls array. Add the required scopes under auth.requiredScopes. Then run hs project upload to deploy the app to HubSpot.
4

Get your credentials

In the HubSpot account, go to Development > Projects, open the project, click the app name, and open the Auth tab. Copy the Client ID and Client secret.
Never share your Client secret publicly. Store it securely and only enter it in the Alter Vault Developer Portal.

​
Step 2: Add to Alter Vault

1

Open the Developer Portal

Go to portal.alterauth.com and navigate to your app.
2

Add HubSpot provider

Go to OAuth Providers > Add Provider > HubSpot.
3

Enter credentials

  • Client ID: Paste your HubSpot Client ID
  • Client Secret: Paste your HubSpot Client secret
4

Select scopes

Choose the scopes your app needs.
5

Save

Click Save. The provider is now active.

​
Available Scopes

ScopeDescription
crm.objects.contacts.readRead contact records
crm.objects.contacts.writeCreate, update, and delete contacts
crm.objects.companies.readRead company records
crm.objects.companies.writeCreate, update, and delete companies
crm.objects.deals.readRead deal records
crm.objects.deals.writeCreate, update, and delete deals

​
Notes

  • HubSpot enforces granular scopes — request only what your app needs.
  • Access tokens are short-lived (~30 minutes). Alter Vault handles automatic refresh using the refresh token.
  • See the HubSpot OAuth documentation for more details.