Issue Station
Sign In
Tools hereToolbox

n8n - 💡(How to fix) Fix Hide or remove deprecated "HubSpot API" credential type (API keys were sunset Nov 2022) [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
n8n-io/n8n#29398•Fetched 2026-04-29 06:35:08
View on GitHub
Comments
1
Participants
2
Timeline
3
Reactions
0
Author
Anou4rAnou4r
Participants
Anou4rAnou4rn8n-assistant[bot]n8n-assistant[bot]
Timeline (top)
closed ×1commented ×1labeled ×1
RAW_BUFFERClick to expand / collapse

Problem

The HubSpot API credential type (HubspotApi.credentials.ts) authenticates via the hapikey query parameter, which HubSpot fully sunset on November 30, 2022 [1]. Existing API keys created via this method no longer authenticate against the HubSpot API.

The credential is still listed in the credential picker UI when adding a HubSpot node, which leads new users to pick a non-functional auth method. The source file contains a deprecation notice in a code comment, but this is not surfaced anywhere in the UI.

Reproduction

  1. Add any HubSpot node in a new workflow
  2. Click "Create new credential"
  3. Dropdown shows four options — HubSpot API is among them with no visible deprecation marker
  4. Selecting it leads to an unusable credential

Replacement Auth Methods

Per HubSpot's migration guide, the supported credential types now are:

  • HubSpot App Token (Private Apps with static access tokens) — recommended for internal/single-account integrations. Already exists in n8n as HubspotAppToken.
  • HubSpot OAuth2 API (Public Apps via OAuth flow) — for multi-account / marketplace apps. Already exists in n8n as HubspotOAuth2Api.
  • HubSpot Developer API — only for configuring Public/Marketplace apps in a Developer Account, not for actual data access.

Expected

One of:

  • Remove HubspotApi.credentials.ts entirely (breaking, requires migration path)
  • Hide it from the credential picker (mark deprecated/internal) but keep the type for legacy workflow loading (doesn't make sense really)
  • Show a deprecation banner in the credential UI pointing users to HubSpot App Token

n8n Version

2.18.4

Reference

[1] https://developers.hubspot.com/changelog/upcoming-api-key-sunset

extent analysis

TL;DR

Remove or hide the deprecated HubSpot API credential type from the credential picker UI to prevent users from selecting a non-functional authentication method.

Guidance

  • Identify and assess the impact of removing HubspotApi.credentials.ts on existing workflows that may still be using the deprecated credential type.
  • Consider adding a deprecation banner or notice in the credential UI to inform users about the sunset of the hapikey query parameter and direct them to use the recommended HubSpot App Token or HubSpot OAuth2 API instead.
  • Evaluate the feasibility of automatically migrating existing workflows to use the new credential types, if possible.
  • Review the HubspotAppToken and HubspotOAuth2Api credential types to ensure they are properly configured and functional.

Example

No code snippet is provided as it is not necessary for this guidance.

Notes

The removal or hiding of the deprecated credential type may require additional steps to ensure a smooth transition for users, such as providing a migration path or support for legacy workflows.

Recommendation

Apply a workaround by hiding the HubSpot API credential type from the credential picker UI and displaying a deprecation notice to direct users to the recommended authentication methods, as removing it entirely may cause breaking changes.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#api#model compatibility#GPU setup#container setup#orchestration issue

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

n8n - 💡(How to fix) Fix Hide or remove deprecated "HubSpot API" credential type (API keys were sunset Nov 2022) [1 comments, 2 participants]