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 AutomationOperationsSales
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-07-11'
method: derived
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