---
title: "HubSpot API key: where it went and what replaced it"
description: "Where your HubSpot API key went: HubSpot retired API keys in 2022. What replaced them, how to create a service key, and how to migrate an old integration."
url: "https://jetstack.ai/answers/hubspot-api-key/"
---

# 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.

![](https://jetstack.ai/images/authors/aditya-kumar.webp)

By [Aditya Kumar](https://jetstack.ai/authors/aditya-kumar/) Founder, Jetstack AI

Updated October 29, 2026

On this page

## What HubSpot supports natively

HubSpot’s credentials have changed twice in four years:

| Credential                                  | Status (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 token             | Still works. Creation disabled on September 28, 2026 for new accounts and October 26, 2026 for existing accounts |
| Service key                                 | The current way to call the REST APIs from your own account                                                      |
| OAuth app                                   | For 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](https://jetstack.ai/answers/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](https://jetstack.ai/answers/hubspot-private-app).

## 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](https://jetstack.ai/docs/developers/authentication) and the [developer overview](https://jetstack.ai/docs/developers).

## Sources

- [Account service keys (HubSpot Developers)](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/account-service-keys)
- [Legacy private app creation sunset (HubSpot Developer Changelog)](https://developers.hubspot.com/changelog/legacy-private-app-creation-sunset)
- [Authentication (Jetstack AI documentation)](https://jetstack.ai/docs/developers/authentication)

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

![Aditya Kumar](https://jetstack.ai/images/authors/aditya-kumar.webp)

About the author

[Aditya Kumar](https://jetstack.ai/authors/aditya-kumar/)

Founder, Jetstack AI

Aditya Kumar is the founder of Jetstack AI, the AI platform HubSpot partners and RevOps teams use to audit portals, build implementations and reuse their best setups across portals. He writes about HubSpot architecture, automation and AI from the work of building it.

[More from Aditya](https://jetstack.ai/authors/aditya-kumar/) [LinkedIn](https://www.linkedin.com/in/aditya-ambrstack/)

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](https://jetstack.ai/docs/developers)

On this page

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.
