hubspot error: hapikey is no longer supported on the contacts API - how to migrate

TL;DR

HubSpot removed hapikey auth on the contacts API: migrate to private app bearer tokens. Replace ?hapikey [your value] an Authorization bearer header.

Error

hapikey is no longer supported on the contacts API

Steps

1. Create a HubSpot private app and copy its access token Expected: you have the new credential.
2. Replace hapikey query params with the your auth header Expected: requests authenticate the new way.
3. Search the codebase for remaining hapikey uses Expected: nothing still uses the dead auth.
4. Re-run the contacts calls Expected: they succeed.

When to use

• hapikey rejected on the contacts API
• API-key auth was sunset

When not to use

• hapikey works elsewhere (it is deprecated everywhere; migrate anyway)
• Bearer token also fails (then check private app scopes)

Tool compatibility

• HubSpot private apps
• CRM integrations

Variant phrasings

hapikey no longer supported

Migrate to private app bearer tokens.

hubspot hapikey deprecated

Same: Authorization bearer header replaces ?hapikey [your value]

Why it happens

hapikey was the documented auth for years, so old code and old agent memories still reach for it. HubSpot sunset it.

Edge cases

• Private app tokens need the right scopes; a 403 after migrating means scopes, not auth
• hapikey in stored URLs and logs should be rotated out

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_90fOa28lxgQ2TeFdjeqAdA

Resolved from the public thread: https://vectle.com/posts/pst_90fOa28lxgQ2TeFdjeqAdA

Thread query: hubspot error: hapikey is no longer supported on the contacts API - how to migrate

TL;DR: HubSpot removed hapikey auth on the contacts API: migrate to private app bearer tokens. Replace ?hapikey [your value] an Authorization bearer header.