Notion · Authentication Profile

Notion Authentication

Authentication

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

CollaborationDatabaseIdeasNotesProductivityProjectT1TaskWikiWorkspace

Methods: http, oauth2 Schemes: 2 OAuth flows: authorizationCode API key in:

Security Schemes

bearerAuth http

scheme: bearer

oauth2 oauth2

· flows: authorizationCode

Source

Authentication Profile

generated: '2026-06-20'
method: searched
source: openapi/notion-openapi.yml
docs: https://developers.notion.com/reference/authentication
summary:
  types:
  - http
  - oauth2
  api_key_in: []
  oauth2_flows:
  - authorizationCode
  authorization_model: capabilities
schemes:
- name: bearerAuth
  type: http
  scheme: bearer
  description: Notion API uses bearer token authentication. Obtain an integration token from
    https://www.notion.so/my-integrations. Pass the token in the Authorization header as "Bearer
    {token}".
  token_types:
  - internal integration token
  - personal access token
  sources:
  - openapi/notion-openapi.yml
- name: oauth2
  type: oauth2
  description: >-
    Public connections authorize end users via OAuth 2.0 authorization code flow.
    What a token can do is governed by integration "capabilities" (read/insert/update
    content, read/insert comments, read user info) rather than granular OAuth scopes.
  flows:
  - flow: authorizationCode
    authorizationUrl: https://api.notion.com/v1/oauth/authorize
    tokenUrl: https://api.notion.com/v1/oauth/token
    refresh: true
  docs: https://developers.notion.com/guides/get-started/authorization
  capabilities_docs: https://developers.notion.com/reference/capabilities
  sources:
  - https://developers.notion.com/reference/authentication
notes:
  - The remote Notion MCP server (mcp.notion.com) requires user-based OAuth; discovery at /.well-known/oauth-authorization-server.
  - No granular OAuth scope surface — capabilities are configured per integration; scopes/ artifact intentionally omitted.

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/notion-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 form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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