Skip to content
Book a build

Where is my HubSpot API key, and what replaced it?

You won't find a HubSpot API key any more: HubSpot stopped supporting API keys on November 30, 2022. For an integration in your own account, create a service key under Development, Keys, Service keys, choose its scopes and send it as a Bearer token. Existing legacy private app tokens still work, but new ones can't be created. Apps for other accounts use OAuth.

On this page

What HubSpot supports natively

HubSpot’s credentials have changed twice in four years:

CredentialStatus (October 2026)
Account API key (hapikey query parameter)Retired. No new keys after July 15, 2022; unsupported after November 30, 2022
Legacy private app access tokenStill works. Creation disabled on September 28, 2026 for new accounts and October 26, 2026 for existing accounts
Service keyThe current way to call the REST APIs from your own account
OAuth appFor integrations that other HubSpot accounts install

The change from API keys was mostly mechanical: instead of a key in the query string, you send a token in the Authorization header, and that token carries scopes, so each integration gets only the access it needs.

How to create the replacement for a HubSpot API key

  1. Make sure you’re a Super Admin or have the Developer tools access permission.
  2. Go to Development → Keys → Service keys and click Create service key.
  3. Name it after the integration that will use it, add the scopes it needs, and create it.
  4. Store the key in a secret manager, then send it as Authorization: Bearer <key>.

Service keys only make REST API requests. They can’t authenticate webhooks or calls inside UI extensions; for those, create an app and use its access token.

How to migrate an integration that used an API key

  1. List what the integration calls, endpoint by endpoint.
  2. Map each endpoint to a scope, for example crm.objects.contacts.read for reading contacts.
  3. Create a service key with exactly those scopes.
  4. Move authentication to the header and remove the hapikey parameter.
  5. Check limits. Service keys share the account’s daily limit with other privately distributed apps; see HubSpot API rate limits.

If you still run a legacy private app, it keeps working. For what to do with it now, see HubSpot private apps.

Where Jetstack AI fits

Jetstack AI’s own API doesn’t take HubSpot credentials. Your portals connect to Jetstack once, and you authenticate to https://api.jetstack.ai with a Jetstack API key (it starts with jsai_), choosing its scopes or a preset such as Read-only. See authentication and the developer overview.

Sources

Checked October 29, 2026. HubSpot changes its products often; tell us at team@jetstack.ai if something here is out of date.

API & developers

Do it from your own code or AI agent.

The Jetstack AI REST API, MCP server and CLI share API keys and scopes. Create and manage those keys in the app.

Read the developer docs

API & developers

Related questions.

Where is my HubSpot API key, and what replaced it?

You won't find a HubSpot API key any more: HubSpot stopped supporting API keys on November 30, 2022. For an integration in your own account, create a service key under Development, Keys, Service keys, choose its scopes and send it as a Bearer token. Existing legacy private app tokens still work, but new ones can't be created. Apps for other accounts use OAuth.

An old tool asks for my HubSpot API key. What do I give it?

Nothing that will work as an API key. Check whether the tool supports a service key or private app access token, or connects through OAuth from HubSpot's App Marketplace. If it only accepts the old key format, it hasn't worked since November 2022.

What does 'developer API key' mean in HubSpot?

Developer account API keys, used to configure public apps from a developer account, were not part of the 2022 sunset. They're a separate thing from the account API keys that were retired.

How do I rotate a service key?

From the key's page, rotate and expire it now, or rotate and expire the old key in 7 days. You can also turn on automatic rotation every 3, 6 or 12 months; HubSpot recommends rotating every six months.