HubSpot · Authentication Profile

Hubspot Authentication

Authentication

HubSpot secures its APIs with apiKey, http, and oauth2 across 5 declared security schemes, as derived from its OpenAPI definitions. OAuth 2.0 is offered via the authorizationCode flow(s).

AnalyticsCommerceContentCRMCustomer ServiceEmail MarketingMarketingMarketing AutomationSales
Methods: apiKey, http, oauth2 Schemes: 5 OAuth flows: authorizationCode API key in: header, query

Security Schemes

OAuth2 oauth2
· flows: authorizationCode
PrivateApp apiKey
· in: header (private-app)
oauth2 http
scheme: bearer
ApiKeyAuth apiKey
· in: query (hapikey)
privateApp apiKey
· in: header (Authorization)

Source

Authentication Profile

Raw ↑ 
generated: '2026-08-13'
method: searched
source: openapi/hubspot-analytics-events-api-openapi.yml, openapi/hubspot-authors-api-openapi.yml, openapi/hubspot-blog-posts-api-openapi.yml,
  openapi/hubspot-cms-hubdb-api-openapi.yml, openapi/hubspot-cms-pages-api-openapi.yml, openapi/hubspot-commerce-payments-api-openapi.yml,
  openapi/hubspot-commerce-subscriptions-api-openapi.yml, openapi/hubspot-conversations-api-openapi.yml,
  openapi/hubspot-crm-associations-api-openapi.yml, openapi/hubspot-crm-companies-api-openapi.yml, openapi/hubspot-crm-contacts-api-openapi.yml,
  openapi/hubspot-crm-deals-api-openapi.yml ...
summary:
  types:
  - apiKey
  - http
  - oauth2
  api_key_in:
  - header
  - query
  oauth2_flows:
  - authorizationCode
schemes:
- name: OAuth2
  type: oauth2
  flows:
  - flow: authorizationCode
    authorizationUrl: https://app.hubspot.com/oauth/authorize
    tokenUrl: https://api.hubapi.com/oauth/v1/token
    scopes: 1
  sources:
  - openapi/hubspot-analytics-events-api-openapi.yml
  - openapi/hubspot-authors-api-openapi.yml
  - openapi/hubspot-blog-posts-api-openapi.yml
  - openapi/hubspot-commerce-payments-api-openapi.yml
  - openapi/hubspot-conversations-api-openapi.yml
  - openapi/hubspot-crm-associations-api-openapi.yml
  - openapi/hubspot-custom-workflow-actions-api-openapi.yml
  - openapi/hubspot-domains-api-openapi.yml
  - openapi/hubspot-engagement-calls-api-openapi.yml
  - openapi/hubspot-engagement-notes-openapi.yml
  - openapi/hubspot-marketing-emal-api-openapi.yml
  - openapi/hubspot-source-code-api-openapi.yml
- name: PrivateApp
  type: apiKey
  in: header
  parameter: private-app
  sources:
  - openapi/hubspot-authors-api-openapi.yml
  - openapi/hubspot-blog-posts-api-openapi.yml
  - openapi/hubspot-conversations-api-openapi.yml
  - openapi/hubspot-crm-associations-api-openapi.yml
  - openapi/hubspot-source-code-api-openapi.yml
- name: oauth2
  type: http
  scheme: bearer
  description: OAuth 2.0 Bearer token (access token from OAuth flow)
  sources:
  - openapi/hubspot-cms-hubdb-api-openapi.yml
  - openapi/hubspot-cms-pages-api-openapi.yml
  - openapi/hubspot-commerce-subscriptions-api-openapi.yml
  - openapi/hubspot-crm-companies-api-openapi.yml
  - openapi/hubspot-crm-contacts-api-openapi.yml
  - openapi/hubspot-crm-deals-api-openapi.yml
  - openapi/hubspot-crm-lists-api-openapi.yml
  - openapi/hubspot-crm-search-api-openapi.yml
  - openapi/hubspot-crm-tickets-api-openapi.yml
  - openapi/hubspot-engagement-emails-api-openapi.yml
  - openapi/hubspot-engagement-meetings-api-openapi.yml
  - openapi/hubspot-engagement-tasks-api-openapi.yml
- name: ApiKeyAuth
  type: apiKey
  in: query
  parameter: hapikey
  description: HubSpot API key for authentication
  sources:
  - openapi/hubspot-crm-feature-flags-api-openapi.yml
- name: privateApp
  type: apiKey
  in: header
  parameter: Authorization
  description: Private app access token with prefix "Bearer"
  sources:
  - openapi/hubspot-custom-workflow-actions-api-openapi.yml
  - openapi/hubspot-domains-api-openapi.yml
  - openapi/hubspot-engagement-calls-api-openapi.yml
  - openapi/hubspot-engagement-notes-openapi.yml
  - openapi/hubspot-marketing-emal-api-openapi.yml
docs: https://developers.hubspot.com/docs/api/intro-to-auth
authorization_server_metadata:
  app:
    url: https://app.hubspot.com/.well-known/oauth-authorization-server
    http_status: 200
    issuer: https://app.hubspot.com
    authorization_endpoint: https://app.hubspot.com/oauth/authorize
    token_endpoint: https://api.hubapi.com/oauth/v1/token
    response_types_supported:
    - code
    code_challenge_methods_supported:
    - S256
  mcp:
    url: https://mcp.hubspot.com/.well-known/oauth-authorization-server
    http_status: 200
    issuer: https://mcp.hubspot.com
    authorization_endpoint: https://mcp.hubspot.com/oauth/authorize/user
    token_endpoint: https://mcp.hubspot.com/oauth/v3/token
    introspection_endpoint: https://mcp.hubspot.com/oauth/v3/token/introspect
    grant_types_supported:
    - authorization_code
    - refresh_token
    - client_credentials
    code_challenge_methods_supported:
    - S256
    note: served identically from api.hubapi.com/.well-known/oauth-authorization-server; this is the MCP
      authorization server, NOT the classic app one
  method: probed
  probed: '2026-08-13'
methods:
- name: OAuth 2.0 authorization code
  use: public apps installed into customer portals
  header: 'Authorization: Bearer <token>'
  pkce: S256 supported
- name: Private app access token
  use: single-portal integrations
  header: 'Authorization: Bearer <token>'
  note: no scope-negotiation flow; scopes are picked in the private-app settings
- name: HubSpot API key (hapikey)
  use: legacy
  status: deprecated
  note: the query-string apiKey scheme still present in some harvested specs is the retired hapikey mechanism;
    new integrations must not use it
live_probe:
  url: https://api.hubapi.com/crm/v3/objects/contacts?limit=1
  http_status: 401
  category: INVALID_AUTHENTICATION
  headers:
    x-hubspot-auth-failure: 401 Unauthorized
    x-hubspot-correlation-id: <uuid>
  probed: '2026-08-13'
scopes: scopes/hubspot-scopes.yml

Work with this as data

Every security artifact here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for security posture

4 MCP tools reach this
  • find_securityBrowse and filter every security artifact in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This security artifact 
curl "https://apis.io/api/v1/security/hubspot-authentication"
All security posture 
curl "https://apis.io/api/v1/security?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.