Notion website screenshot

Notion

Notion is an all-in-one workspace that combines notes, tasks, wikis, and databases. The Notion API allows developers to integrate Notion with other tools and build custom applications on top of Notion's platform.

Notion publishes 6 APIs on the APIs.io network, including Blocks API, Comments API, Databases API, and 3 more. Tagged areas include Collaboration, Database, Ideas, Notes, and Productivity.

The Notion catalog on APIs.io includes 1 event-driven AsyncAPI specification, 1 JSON-LD context, and 2 Spectral governance rulesets.

Notion’s developer surface includes changelog, CLI, authentication, documentation, engineering blog, code examples, FAQ, and 106 more developer resources.

🌐 Visit website 📡 Source on GitHub
58.7/100 strong ▬ flat Agent 52/100 agent ready open core · MIT Full breakdown ↓
scored 2026-09-08 · rubric v0.20.0
AccessFreemiumSelf serve⚡ Free to try
1 APIs 1 MCP Servers 16 Features
CollaborationDatabaseIdeasNotesProductivityProjectT1TaskWikiWorkspace

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-09-08 · rubric v0.20.0
Composite quality — 58.7/100 · strong
Contract Quality 15.0 / 20
Developer Ergonomics 12.0 / 16
Access Clarity 8.8 / 16
Operational Transparency 6.6 / 10
Contract Governance 1.7 / 10
Discoverability 4.2 / 8
Open Source Surface 5.0 / 10
Create-or-Update Ergonomics 0.0 / 10
Agent readiness — 52/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
Documented Reversibility 0 / 6
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Delegated User Identity 6 / 6
Protected Resource Metadata 5 / 5
Registration Without a Human 6 / 6
Agentic Commerce Well-Known Document 0 / 5
Open Source Surface applies to this provider. This product is open source and we read its repository directly, so Open Source Surface carries 10 points of the composite. It is scored from what the repository actually publishes — a security policy, a contribution guide, a release history, a code of conduct — read live from the provider rather than inferred from our own catalog pointers. This facet adds; nothing was taken away to make room for it. An open-source project is not excused from the commercial facets, because exemption would strip it of the points it does earn. If we have the wrong repository, or this product is not open source, say so on your provider repo and we will drop the facet rather than have you publish against it.
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.
The six quality facets above are damped to 80 points between them, because the conditional facet above carries the other 20. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 80% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/notion: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

APIs 6

Individual APIs this provider publishes, each with its own machine-readable definition.

Notion Blocks API

Blocks are the fundamental units of content in Notion. Every page is composed of blocks, which can be paragraphs, headings, images, tables, lists, and many other types. Blocks c...

Notion Comments API

Comments allow integrations to read and create comments on pages and blocks within Notion. Comments support rich text content and are associated with discussion threads.

Notion Databases API

Databases are collections of Notion pages organized with a shared schema of properties. Each database defines columns (properties) that all its pages share. Databases support fi...

Notion Pages API

Pages represent documents in Notion workspaces. They can exist as standalone pages or as entries within a database. Pages contain properties (metadata) and content composed of b...

Notion Search API

Search allows querying across all pages and databases that the integration has access to. Results can be filtered by object type and sorted by relevance or last edited time.

Notion Users API

Users represent people or bots in a Notion workspace. Person users are human members of the workspace, while bot users represent API integrations. Use these endpoints to list us...

Postman Collections 1

Ready-to-run Postman collections for exercising this provider's APIs.

Notion API

POSTMAN

Open Collections 8

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

API Collection

OPEN COLLECTION

Notion Blocks API

OPEN COLLECTION

Notion Blocks Comments API

OPEN COLLECTION

Notion Blocks Databases API

OPEN COLLECTION

Notion Blocks Pages API

OPEN COLLECTION

Notion Blocks Search API

OPEN COLLECTION

Notion Blocks Users API

OPEN COLLECTION

Notion API

OPEN COLLECTION

Scroll for all 8

Arazzo Workflows 11

Multi-step API workflows described with the Arazzo specification.

Notion Edit and Optionally Delete a Page Block

List a page's blocks, update the first block's text, then optionally archive it based on a flag.

ARAZZO

Notion Reply to an Existing Comment Thread

List a page's unresolved comments, then reply into the existing discussion or start a new one.

ARAZZO

Notion Create a Database, Seed a Page, and Add Content

Stand up a new Notion database under a page, add a first entry, then fill that entry with content blocks.

ARAZZO

Notion Create a Page and Read Back Its Content

Create a standalone page with content blocks, then retrieve that page's block children.

ARAZZO

Notion Sync a Row into a Database Data Source

Discover a database by title, read its schema, then add a new page row whose properties conform to it.

ARAZZO

Notion Export a Database Record with Its Content

Read a database schema, query its first record, then pull that record's page content blocks.

ARAZZO

Notion Evolve a Database Schema and Re-Query

Retrieve a database, add a property to its schema, then query it back to confirm the change.

ARAZZO

Notion Audit a Single Page Property

Retrieve a page, then fetch one named property item from it in full (including paginated values).

ARAZZO

Notion Query a Database and Update a Matched Page

Query a database with a filter, retrieve the first matching page, then update its properties.

ARAZZO

Notion Search for a Page and Comment on It

Search the workspace by title for a page, then leave a comment on the first matching page.

ARAZZO

Notion Resolve a Workspace User Directory

Identify the integration bot, list workspace users, then retrieve the first user in detail.

ARAZZO

Scroll for all 11

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Notion MCP Server

MCP SERVER

GraphQL 1

GraphQL schemas published by this provider.

Notion GraphQL

Notion does not expose a public GraphQL endpoint. Notion's public API is a versioned REST API (`api.notion.com/v1`). The GraphQL schema in `notion-schema.graphql` is a comprehen...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Notion Plans Pricing

4 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Notion Rate Limits

3 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Notion Finops

FINOPS

Features 16

Notable capabilities this provider offers.

Free plan with trial AI, basic forms/sites, 7-day page history
Plus at $10/member/mo with unlimited file uploads and 30-day history
Business at $20/member/mo with Notion Agent, SAML SSO, AI Meeting Notes
Enterprise with SCIM, audit log, zero-retention with LLM providers
REST API for pages, databases, blocks, users, comments, search
Rate limit: ~3 req/sec average per integration
Webhooks for page and database changes
Notion AI integrated across editor and search
Notion Calendar and Notion Mail
Database queries with filters, sorts, and rollups
Custom forms and public sites
Up to 1,000 blocks per request
OAuth 2.0 for public integrations; internal integration tokens
Synced blocks for multi-page content reuse
Comments and mentions across pages
Page version history (7/30/90 days/unlimited by tier)

Scroll for all 16

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Notion Webhooks

AsyncAPI 2.6 description of the Notion webhooks surface. Notion delivers workspace events (page, database, data source, and comment changes) to a subscriber-hosted HTTPS endpoin...

ASYNCAPI

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Notion Context

0 classes · 12 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Notion API Rules

6 rules · 1 errors 5 warnings

SPECTRAL

Notion API Rules

6 rules · 5 warnings 1 info

SPECTRAL

JSON Schema 14

Standalone JSON Schema definitions for this provider's data models.

Notion Block

43 properties

JSON SCHEMA

Comment

8 properties

JSON SCHEMA

Notion Database

18 properties

JSON SCHEMA

Emoji

2 properties

JSON SCHEMA

Error

5 properties

JSON SCHEMA

ExternalFile

2 properties

JSON SCHEMA

File

5 properties

JSON SCHEMA

Notion Page

15 properties

JSON SCHEMA

PaginatedList

6 properties

JSON SCHEMA

Parent

5 properties

JSON SCHEMA

PartialUser

2 properties

JSON SCHEMA

PropertySchema

3 properties

JSON SCHEMA

RichText

7 properties

JSON SCHEMA

User

7 properties

JSON SCHEMA

Scroll for all 14

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Notion Structure

0 properties

JSON STRUCTURE

Security Posture 4

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Notion Authentication

http/oauth2 · 2 schemes

SECURITY

Notion Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Notion Vulnerability Disclosure

security.txt · contact published

SECURITY

Notion Trust Center

SOC 2, ISO 27001, ISO 27017, ISO 27018, HIPAA, GDPR

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Notion Agentic Access

19 operations · 10 acting

19 operations · 10 acting

AGENTIC

Resources

Get Started 2

Portal, sign-up, and the first successful call

GettingStarted
GettingStarted
 Portal
Portal

Documentation 42

Reference material describing how the API behaves

Guide
Guide
 Documentation
Documentation
 Guide
Guide
 Guide
Guide
 Documentation
Documentation
 OpenAPI
OpenAPI
 Guide
Guide
 Guide
Guide
 Guide
Guide
 Guide
Guide
 Documentation
Documentation
 Guide
Guide
 Documentation
Documentation
 Guide
Guide
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation
 Documentation
Documentation

Scroll for all 42

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

MCPServer
MCPServer
 LLMsTxt
LLMsTxt
 WellKnown
WellKnown
 AgenticAccess
AgenticAccess

Design & Contract 20

Pagination, idempotency, versioning, errors, and events

Conformance
Conformance
 ErrorCatalog
ErrorCatalog
 Lifecycle
Lifecycle
 Conventions
Conventions
 DataModel
DataModel
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Versioning
Versioning
 ErrorCodes
ErrorCodes
 Webhooks
Webhooks
 Webhooks
Webhooks

Scroll for all 20

Build 10

SDKs, sample code, and the tooling you integrate with

PostmanWorkspace
PostmanWorkspace
 Packages
Packages
 CLI
CLI
 Examples
Examples
 IntegrationGallery
IntegrationGallery
 SDKs
SDKs
 SDKs
SDKs
 GitHubRepo
GitHubRepo
 GitHubOrg
GitHubOrg
 SDKs
SDKs

Scroll for all 10

Access & Security 9

Authentication, authorization, and security posture

SecurityTxt
SecurityTxt
 TrustCenter
TrustCenter
 VulnerabilityDisclosure
VulnerabilityDisclosure
 DomainSecurity
DomainSecurity
 Authentication
Authentication
 Authentication
Authentication
 Authorization
Authorization
 Security
Security
 Security
Security

Scroll for all 9

Operate 12

Status, limits, changes, and where to get help

IssueTracker
IssueTracker
 Releases
Releases
 ChangeLog
ChangeLog
 ChangeLog
ChangeLog
 RateLimits
RateLimits
 FAQ
FAQ
 ChangeLog
ChangeLog
 StatusPage
StatusPage
 Support
Support
 Community
Community
 StackOverflow
StackOverflow
 ChangeLog
ChangeLog

Scroll for all 12

Commercial 5

Pricing, plans, and the legal terms of use

License
License
 TermsOfService
TermsOfService
 TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy
 Pricing
Pricing

Company 4

The organization behind the API

Website
Website
 Blog
Blog
 Partners
Partners
 LinkedIn
LinkedIn

Other 5

Properties that don't map to a standard resource type

Overlay
Overlay
X
X
 X
X
 Reddit
Reddit

Source (apis.yml)

apis.yml Raw ↑ 
aid: notion
url: https://raw.githubusercontent.com/api-evangelist/notion/refs/heads/main/apis.yml
apis:
- aid: notion:notion-blocks-api
  name: Notion Blocks API
  description: Blocks are the fundamental units of content in Notion. Every page is composed of blocks, which can be paragraphs,
    headings, images, tables, lists, and many other types. Blocks can have children, forming a tree structure. Use these endpoints
    to retrieve, update, delete blocks and manage block children.
  humanURL: https://developers.notion.com
  tags:
  - Blocks
  properties:
  - type: OpenAPI
    url: openapi/notion-blocks-api-openapi.yml
  - type: Documentation
    url: https://developers.notion.com
  - type: AsyncAPI
    url: asyncapi/notion-webhooks-asyncapi.yml
  - type: JSONSchema
    url: json-schema/notion-page-schema.json
  - type: JSONSchema
    url: json-schema/notion-database-schema.json
  - type: JSONSchema
    url: json-schema/notion-block-schema.json
  - type: JSONLD
    url: json-ld/notion-context.jsonld
  - type: Authentication
    url: https://developers.notion.com/reference/authentication
  - type: Authorization
    url: https://developers.notion.com/docs/authorization
  - type: GettingStarted
    url: https://developers.notion.com/docs/getting-started
  - type: GitHubRepo
    url: https://github.com/makenotion/notion-sdk-js
  - type: BaseURL
    url: https://api.notion.com
  - type: IntroductionAPI
    url: https://developers.notion.com/reference/intro
  - type: DatabaseCreateAPI
    url: https://developers.notion.com/reference/create-a-database
  - type: DatabaseRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-database
  - type: DatabaseUpdateAPI
    url: https://developers.notion.com/reference/update-a-database
  - type: DatabaseQueryAPI
    url: https://developers.notion.com/reference/post-database-query
  - type: PageCreateAPI
    url: https://developers.notion.com/reference/post-page
  - type: PageRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-page
  - type: PageUpdateAPI
    url: https://developers.notion.com/reference/patch-page
  - type: PageTrashAPI
    url: https://developers.notion.com/reference/archive-a-page
  - type: PageMoveAPI
    url: https://developers.notion.com/reference/move-page
  - type: PagePropertyRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-page-property
  - type: PageMarkdownRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-page-markdown
  - type: PageMarkdownUpdateAPI
    url: https://developers.notion.com/reference/update-page-markdown
  - type: BlockRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-block
  - type: BlockUpdateAPI
    url: https://developers.notion.com/reference/update-a-block
  - type: BlockDeleteAPI
    url: https://developers.notion.com/reference/delete-a-block
  - type: BlockChildrenRetrieveAPI
    url: https://developers.notion.com/reference/get-block-children
  - type: BlockChildrenAppendAPI
    url: https://developers.notion.com/reference/patch-block-children
  - type: UsersListAPI
    url: https://developers.notion.com/reference/get-users
  - type: UserRetrieveAPI
    url: https://developers.notion.com/reference/get-user
  - type: UserBotRetrieveAPI
    url: https://developers.notion.com/reference/get-self
  - type: CommentCreateAPI
    url: https://developers.notion.com/reference/create-a-comment
  - type: CommentsListAPI
    url: https://developers.notion.com/reference/list-comments
  - type: CommentRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-comment
  - type: SearchAPI
    url: https://developers.notion.com/reference/post-search
  - type: DataSourceCreateAPI
    url: https://developers.notion.com/reference/create-a-data-source
  - type: DataSourceRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-data-source
  - type: DataSourceUpdateAPI
    url: https://developers.notion.com/reference/update-a-data-source
  - type: DataSourceQueryAPI
    url: https://developers.notion.com/reference/query-a-data-source
  - type: DataSourceTemplatesListAPI
    url: https://developers.notion.com/reference/list-data-source-templates
  - type: FileUploadCreateAPI
    url: https://developers.notion.com/reference/create-a-file-upload
  - type: FileUploadSendAPI
    url: https://developers.notion.com/reference/send-a-file-upload
  - type: FileUploadCompleteAPI
    url: https://developers.notion.com/reference/complete-a-file-upload
  - type: FileUploadRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-file-upload
  - type: FileUploadsListAPI
    url: https://developers.notion.com/reference/list-file-uploads
  - type: TokenCreateAPI
    url: https://developers.notion.com/reference/create-a-token
  - type: TokenIntrospectAPI
    url: https://developers.notion.com/reference/introspect-token
  - type: TokenRefreshAPI
    url: https://developers.notion.com/reference/refresh-a-token
  - type: TokenRevokeAPI
    url: https://developers.notion.com/reference/revoke-token
  - type: GraphQL
    url: graphql/notion-graphql.md
- aid: notion:notion-comments-api
  name: Notion Comments API
  description: Comments allow integrations to read and create comments on pages and blocks within Notion. Comments support
    rich text content and are associated with discussion threads.
  humanURL: https://developers.notion.com
  tags:
  - Comments
  properties:
  - type: OpenAPI
    url: openapi/notion-comments-api-openapi.yml
  - type: Documentation
    url: https://developers.notion.com
  - type: AsyncAPI
    url: asyncapi/notion-webhooks-asyncapi.yml
  - type: JSONSchema
    url: json-schema/notion-page-schema.json
  - type: JSONSchema
    url: json-schema/notion-database-schema.json
  - type: JSONSchema
    url: json-schema/notion-block-schema.json
  - type: JSONLD
    url: json-ld/notion-context.jsonld
  - type: Authentication
    url: https://developers.notion.com/reference/authentication
  - type: Authorization
    url: https://developers.notion.com/docs/authorization
  - type: GettingStarted
    url: https://developers.notion.com/docs/getting-started
  - type: GitHubRepo
    url: https://github.com/makenotion/notion-sdk-js
  - type: BaseURL
    url: https://api.notion.com
  - type: IntroductionAPI
    url: https://developers.notion.com/reference/intro
  - type: DatabaseCreateAPI
    url: https://developers.notion.com/reference/create-a-database
  - type: DatabaseRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-database
  - type: DatabaseUpdateAPI
    url: https://developers.notion.com/reference/update-a-database
  - type: DatabaseQueryAPI
    url: https://developers.notion.com/reference/post-database-query
  - type: PageCreateAPI
    url: https://developers.notion.com/reference/post-page
  - type: PageRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-page
  - type: PageUpdateAPI
    url: https://developers.notion.com/reference/patch-page
  - type: PageTrashAPI
    url: https://developers.notion.com/reference/archive-a-page
  - type: PageMoveAPI
    url: https://developers.notion.com/reference/move-page
  - type: PagePropertyRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-page-property
  - type: PageMarkdownRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-page-markdown
  - type: PageMarkdownUpdateAPI
    url: https://developers.notion.com/reference/update-page-markdown
  - type: BlockRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-block
  - type: BlockUpdateAPI
    url: https://developers.notion.com/reference/update-a-block
  - type: BlockDeleteAPI
    url: https://developers.notion.com/reference/delete-a-block
  - type: BlockChildrenRetrieveAPI
    url: https://developers.notion.com/reference/get-block-children
  - type: BlockChildrenAppendAPI
    url: https://developers.notion.com/reference/patch-block-children
  - type: UsersListAPI
    url: https://developers.notion.com/reference/get-users
  - type: UserRetrieveAPI
    url: https://developers.notion.com/reference/get-user
  - type: UserBotRetrieveAPI
    url: https://developers.notion.com/reference/get-self
  - type: CommentCreateAPI
    url: https://developers.notion.com/reference/create-a-comment
  - type: CommentsListAPI
    url: https://developers.notion.com/reference/list-comments
  - type: CommentRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-comment
  - type: SearchAPI
    url: https://developers.notion.com/reference/post-search
  - type: DataSourceCreateAPI
    url: https://developers.notion.com/reference/create-a-data-source
  - type: DataSourceRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-data-source
  - type: DataSourceUpdateAPI
    url: https://developers.notion.com/reference/update-a-data-source
  - type: DataSourceQueryAPI
    url: https://developers.notion.com/reference/query-a-data-source
  - type: DataSourceTemplatesListAPI
    url: https://developers.notion.com/reference/list-data-source-templates
  - type: FileUploadCreateAPI
    url: https://developers.notion.com/reference/create-a-file-upload
  - type: FileUploadSendAPI
    url: https://developers.notion.com/reference/send-a-file-upload
  - type: FileUploadCompleteAPI
    url: https://developers.notion.com/reference/complete-a-file-upload
  - type: FileUploadRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-file-upload
  - type: FileUploadsListAPI
    url: https://developers.notion.com/reference/list-file-uploads
  - type: TokenCreateAPI
    url: https://developers.notion.com/reference/create-a-token
  - type: TokenIntrospectAPI
    url: https://developers.notion.com/reference/introspect-token
  - type: TokenRefreshAPI
    url: https://developers.notion.com/reference/refresh-a-token
  - type: TokenRevokeAPI
    url: https://developers.notion.com/reference/revoke-token
  - type: GraphQL
    url: graphql/notion-graphql.md
- aid: notion:notion-databases-api
  name: Notion Databases API
  description: Databases are collections of Notion pages organized with a shared schema of properties. Each database defines
    columns (properties) that all its pages share. Databases support filtering, sorting, and querying. Use these endpoints
    to create, retrieve, update, and query databases.
  humanURL: https://developers.notion.com
  tags:
  - Databases
  properties:
  - type: OpenAPI
    url: openapi/notion-databases-api-openapi.yml
  - type: Documentation
    url: https://developers.notion.com
  - type: AsyncAPI
    url: asyncapi/notion-webhooks-asyncapi.yml
  - type: JSONSchema
    url: json-schema/notion-page-schema.json
  - type: JSONSchema
    url: json-schema/notion-database-schema.json
  - type: JSONSchema
    url: json-schema/notion-block-schema.json
  - type: JSONLD
    url: json-ld/notion-context.jsonld
  - type: Authentication
    url: https://developers.notion.com/reference/authentication
  - type: Authorization
    url: https://developers.notion.com/docs/authorization
  - type: GettingStarted
    url: https://developers.notion.com/docs/getting-started
  - type: GitHubRepo
    url: https://github.com/makenotion/notion-sdk-js
  - type: BaseURL
    url: https://api.notion.com
  - type: IntroductionAPI
    url: https://developers.notion.com/reference/intro
  - type: DatabaseCreateAPI
    url: https://developers.notion.com/reference/create-a-database
  - type: DatabaseRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-database
  - type: DatabaseUpdateAPI
    url: https://developers.notion.com/reference/update-a-database
  - type: DatabaseQueryAPI
    url: https://developers.notion.com/reference/post-database-query
  - type: PageCreateAPI
    url: https://developers.notion.com/reference/post-page
  - type: PageRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-page
  - type: PageUpdateAPI
    url: https://developers.notion.com/reference/patch-page
  - type: PageTrashAPI
    url: https://developers.notion.com/reference/archive-a-page
  - type: PageMoveAPI
    url: https://developers.notion.com/reference/move-page
  - type: PagePropertyRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-page-property
  - type: PageMarkdownRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-page-markdown
  - type: PageMarkdownUpdateAPI
    url: https://developers.notion.com/reference/update-page-markdown
  - type: BlockRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-block
  - type: BlockUpdateAPI
    url: https://developers.notion.com/reference/update-a-block
  - type: BlockDeleteAPI
    url: https://developers.notion.com/reference/delete-a-block
  - type: BlockChildrenRetrieveAPI
    url: https://developers.notion.com/reference/get-block-children
  - type: BlockChildrenAppendAPI
    url: https://developers.notion.com/reference/patch-block-children
  - type: UsersListAPI
    url: https://developers.notion.com/reference/get-users
  - type: UserRetrieveAPI
    url: https://developers.notion.com/reference/get-user
  - type: UserBotRetrieveAPI
    url: https://developers.notion.com/reference/get-self
  - type: CommentCreateAPI
    url: https://developers.notion.com/reference/create-a-comment
  - type: CommentsListAPI
    url: https://developers.notion.com/reference/list-comments
  - type: CommentRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-comment
  - type: SearchAPI
    url: https://developers.notion.com/reference/post-search
  - type: DataSourceCreateAPI
    url: https://developers.notion.com/reference/create-a-data-source
  - type: DataSourceRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-data-source
  - type: DataSourceUpdateAPI
    url: https://developers.notion.com/reference/update-a-data-source
  - type: DataSourceQueryAPI
    url: https://developers.notion.com/reference/query-a-data-source
  - type: DataSourceTemplatesListAPI
    url: https://developers.notion.com/reference/list-data-source-templates
  - type: FileUploadCreateAPI
    url: https://developers.notion.com/reference/create-a-file-upload
  - type: FileUploadSendAPI
    url: https://developers.notion.com/reference/send-a-file-upload
  - type: FileUploadCompleteAPI
    url: https://developers.notion.com/reference/complete-a-file-upload
  - type: FileUploadRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-file-upload
  - type: FileUploadsListAPI
    url: https://developers.notion.com/reference/list-file-uploads
  - type: TokenCreateAPI
    url: https://developers.notion.com/reference/create-a-token
  - type: TokenIntrospectAPI
    url: https://developers.notion.com/reference/introspect-token
  - type: TokenRefreshAPI
    url: https://developers.notion.com/reference/refresh-a-token
  - type: TokenRevokeAPI
    url: https://developers.notion.com/reference/revoke-token
  - type: GraphQL
    url: graphql/notion-graphql.md
- aid: notion:notion-pages-api
  name: Notion Pages API
  description: Pages represent documents in Notion workspaces. They can exist as standalone pages or as entries within a database.
    Pages contain properties (metadata) and content composed of blocks. Use these endpoints to create, retrieve, update, archive,
    and manage page properties and content.
  humanURL: https://developers.notion.com
  tags:
  - Pages
  properties:
  - type: OpenAPI
    url: openapi/notion-pages-api-openapi.yml
  - type: Documentation
    url: https://developers.notion.com
  - type: AsyncAPI
    url: asyncapi/notion-webhooks-asyncapi.yml
  - type: JSONSchema
    url: json-schema/notion-page-schema.json
  - type: JSONSchema
    url: json-schema/notion-database-schema.json
  - type: JSONSchema
    url: json-schema/notion-block-schema.json
  - type: JSONLD
    url: json-ld/notion-context.jsonld
  - type: Authentication
    url: https://developers.notion.com/reference/authentication
  - type: Authorization
    url: https://developers.notion.com/docs/authorization
  - type: GettingStarted
    url: https://developers.notion.com/docs/getting-started
  - type: GitHubRepo
    url: https://github.com/makenotion/notion-sdk-js
  - type: BaseURL
    url: https://api.notion.com
  - type: IntroductionAPI
    url: https://developers.notion.com/reference/intro
  - type: DatabaseCreateAPI
    url: https://developers.notion.com/reference/create-a-database
  - type: DatabaseRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-database
  - type: DatabaseUpdateAPI
    url: https://developers.notion.com/reference/update-a-database
  - type: DatabaseQueryAPI
    url: https://developers.notion.com/reference/post-database-query
  - type: PageCreateAPI
    url: https://developers.notion.com/reference/post-page
  - type: PageRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-page
  - type: PageUpdateAPI
    url: https://developers.notion.com/reference/patch-page
  - type: PageTrashAPI
    url: https://developers.notion.com/reference/archive-a-page
  - type: PageMoveAPI
    url: https://developers.notion.com/reference/move-page
  - type: PagePropertyRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-page-property
  - type: PageMarkdownRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-page-markdown
  - type: PageMarkdownUpdateAPI
    url: https://developers.notion.com/reference/update-page-markdown
  - type: BlockRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-block
  - type: BlockUpdateAPI
    url: https://developers.notion.com/reference/update-a-block
  - type: BlockDeleteAPI
    url: https://developers.notion.com/reference/delete-a-block
  - type: BlockChildrenRetrieveAPI
    url: https://developers.notion.com/reference/get-block-children
  - type: BlockChildrenAppendAPI
    url: https://developers.notion.com/reference/patch-block-children
  - type: UsersListAPI
    url: https://developers.notion.com/reference/get-users
  - type: UserRetrieveAPI
    url: https://developers.notion.com/reference/get-user
  - type: UserBotRetrieveAPI
    url: https://developers.notion.com/reference/get-self
  - type: CommentCreateAPI
    url: https://developers.notion.com/reference/create-a-comment
  - type: CommentsListAPI
    url: https://developers.notion.com/reference/list-comments
  - type: CommentRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-comment
  - type: SearchAPI
    url: https://developers.notion.com/reference/post-search
  - type: DataSourceCreateAPI
    url: https://developers.notion.com/reference/create-a-data-source
  - type: DataSourceRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-data-source
  - type: DataSourceUpdateAPI
    url: https://developers.notion.com/reference/update-a-data-source
  - type: DataSourceQueryAPI
    url: https://developers.notion.com/reference/query-a-data-source
  - type: DataSourceTemplatesListAPI
    url: https://developers.notion.com/reference/list-data-source-templates
  - type: FileUploadCreateAPI
    url: https://developers.notion.com/reference/create-a-file-upload
  - type: FileUploadSendAPI
    url: https://developers.notion.com/reference/send-a-file-upload
  - type: FileUploadCompleteAPI
    url: https://developers.notion.com/reference/complete-a-file-upload
  - type: FileUploadRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-file-upload
  - type: FileUploadsListAPI
    url: https://developers.notion.com/reference/list-file-uploads
  - type: TokenCreateAPI
    url: https://developers.notion.com/reference/create-a-token
  - type: TokenIntrospectAPI
    url: https://developers.notion.com/reference/introspect-token
  - type: TokenRefreshAPI
    url: https://developers.notion.com/reference/refresh-a-token
  - type: TokenRevokeAPI
    url: https://developers.notion.com/reference/revoke-token
  - type: GraphQL
    url: graphql/notion-graphql.md
- aid: notion:notion-search-api
  name: Notion Search API
  description: Search allows querying across all pages and databases that the integration has access to. Results can be filtered
    by object type and sorted by relevance or last edited time.
  humanURL: https://developers.notion.com
  tags:
  - Search
  properties:
  - type: OpenAPI
    url: openapi/notion-search-api-openapi.yml
  - type: Documentation
    url: https://developers.notion.com
  - type: AsyncAPI
    url: asyncapi/notion-webhooks-asyncapi.yml
  - type: JSONSchema
    url: json-schema/notion-page-schema.json
  - type: JSONSchema
    url: json-schema/notion-database-schema.json
  - type: JSONSchema
    url: json-schema/notion-block-schema.json
  - type: JSONLD
    url: json-ld/notion-context.jsonld
  - type: Authentication
    url: https://developers.notion.com/reference/authentication
  - type: Authorization
    url: https://developers.notion.com/docs/authorization
  - type: GettingStarted
    url: https://developers.notion.com/docs/getting-started
  - type: GitHubRepo
    url: https://github.com/makenotion/notion-sdk-js
  - type: BaseURL
    url: https://api.notion.com
  - type: IntroductionAPI
    url: https://developers.notion.com/reference/intro
  - type: DatabaseCreateAPI
    url: https://developers.notion.com/reference/create-a-database
  - type: DatabaseRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-database
  - type: DatabaseUpdateAPI
    url: https://developers.notion.com/reference/update-a-database
  - type: DatabaseQueryAPI
    url: https://developers.notion.com/reference/post-database-query
  - type: PageCreateAPI
    url: https://developers.notion.com/reference/post-page
  - type: PageRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-page
  - type: PageUpdateAPI
    url: https://developers.notion.com/reference/patch-page
  - type: PageTrashAPI
    url: https://developers.notion.com/reference/archive-a-page
  - type: PageMoveAPI
    url: https://developers.notion.com/reference/move-page
  - type: PagePropertyRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-page-property
  - type: PageMarkdownRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-page-markdown
  - type: PageMarkdownUpdateAPI
    url: https://developers.notion.com/reference/update-page-markdown
  - type: BlockRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-block
  - type: BlockUpdateAPI
    url: https://developers.notion.com/reference/update-a-block
  - type: BlockDeleteAPI
    url: https://developers.notion.com/reference/delete-a-block
  - type: BlockChildrenRetrieveAPI
    url: https://developers.notion.com/reference/get-block-children
  - type: BlockChildrenAppendAPI
    url: https://developers.notion.com/reference/patch-block-children
  - type: UsersListAPI
    url: https://developers.notion.com/reference/get-users
  - type: UserRetrieveAPI
    url: https://developers.notion.com/reference/get-user
  - type: UserBotRetrieveAPI
    url: https://developers.notion.com/reference/get-self
  - type: CommentCreateAPI
    url: https://developers.notion.com/reference/create-a-comment
  - type: CommentsListAPI
    url: https://developers.notion.com/reference/list-comments
  - type: CommentRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-comment
  - type: SearchAPI
    url: https://developers.notion.com/reference/post-search
  - type: DataSourceCreateAPI
    url: https://developers.notion.com/reference/create-a-data-source
  - type: DataSourceRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-data-source
  - type: DataSourceUpdateAPI
    url: https://developers.notion.com/reference/update-a-data-source
  - type: DataSourceQueryAPI
    url: https://developers.notion.com/reference/query-a-data-source
  - type: DataSourceTemplatesListAPI
    url: https://developers.notion.com/reference/list-data-source-templates
  - type: FileUploadCreateAPI
    url: https://developers.notion.com/reference/create-a-file-upload
  - type: FileUploadSendAPI
    url: https://developers.notion.com/reference/send-a-file-upload
  - type: FileUploadCompleteAPI
    url: https://developers.notion.com/reference/complete-a-file-upload
  - type: FileUploadRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-file-upload
  - type: FileUploadsListAPI
    url: https://developers.notion.com/reference/list-file-uploads
  - type: TokenCreateAPI
    url: https://developers.notion.com/reference/create-a-token
  - type: TokenIntrospectAPI
    url: https://developers.notion.com/reference/introspect-token
  - type: TokenRefreshAPI
    url: https://developers.notion.com/reference/refresh-a-token
  - type: TokenRevokeAPI
    url: https://developers.notion.com/reference/revoke-token
  - type: GraphQL
    url: graphql/notion-graphql.md
- aid: notion:notion-users-api
  name: Notion Users API
  description: Users represent people or bots in a Notion workspace. Person users are human members of the workspace, while
    bot users represent API integrations. Use these endpoints to list users, retrieve specific users, or get information about
    the current bot integration.
  humanURL: https://developers.notion.com
  tags:
  - User
  tags_raw:
  - Users
  properties:
  - type: OpenAPI
    url: openapi/notion-users-api-openapi.yml
  - type: Documentation
    url: https://developers.notion.com
  - type: AsyncAPI
    url: asyncapi/notion-webhooks-asyncapi.yml
  - type: JSONSchema
    url: json-schema/notion-page-schema.json
  - type: JSONSchema
    url: json-schema/notion-database-schema.json
  - type: JSONSchema
    url: json-schema/notion-block-schema.json
  - type: JSONLD
    url: json-ld/notion-context.jsonld
  - type: Authentication
    url: https://developers.notion.com/reference/authentication
  - type: Authorization
    url: https://developers.notion.com/docs/authorization
  - type: GettingStarted
    url: https://developers.notion.com/docs/getting-started
  - type: GitHubRepo
    url: https://github.com/makenotion/notion-sdk-js
  - type: BaseURL
    url: https://api.notion.com
  - type: IntroductionAPI
    url: https://developers.notion.com/reference/intro
  - type: DatabaseCreateAPI
    url: https://developers.notion.com/reference/create-a-database
  - type: DatabaseRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-database
  - type: DatabaseUpdateAPI
    url: https://developers.notion.com/reference/update-a-database
  - type: DatabaseQueryAPI
    url: https://developers.notion.com/reference/post-database-query
  - type: PageCreateAPI
    url: https://developers.notion.com/reference/post-page
  - type: PageRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-page
  - type: PageUpdateAPI
    url: https://developers.notion.com/reference/patch-page
  - type: PageTrashAPI
    url: https://developers.notion.com/reference/archive-a-page
  - type: PageMoveAPI
    url: https://developers.notion.com/reference/move-page
  - type: PagePropertyRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-page-property
  - type: PageMarkdownRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-page-markdown
  - type: PageMarkdownUpdateAPI
    url: https://developers.notion.com/reference/update-page-markdown
  - type: BlockRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-block
  - type: BlockUpdateAPI
    url: https://developers.notion.com/reference/update-a-block
  - type: BlockDeleteAPI
    url: https://developers.notion.com/reference/delete-a-block
  - type: BlockChildrenRetrieveAPI
    url: https://developers.notion.com/reference/get-block-children
  - type: BlockChildrenAppendAPI
    url: https://developers.notion.com/reference/patch-block-children
  - type: UsersListAPI
    url: https://developers.notion.com/reference/get-users
  - type: UserRetrieveAPI
    url: https://developers.notion.com/reference/get-user
  - type: UserBotRetrieveAPI
    url: https://developers.notion.com/reference/get-self
  - type: CommentCreateAPI
    url: https://developers.notion.com/reference/create-a-comment
  - type: CommentsListAPI
    url: https://developers.notion.com/reference/list-comments
  - type: CommentRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-comment
  - type: SearchAPI
    url: https://developers.notion.com/reference/post-search
  - type: DataSourceCreateAPI
    url: https://developers.notion.com/reference/create-a-data-source
  - type: DataSourceRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-data-source
  - type: DataSourceUpdateAPI
    url: https://developers.notion.com/reference/update-a-data-source
  - type: DataSourceQueryAPI
    url: https://developers.notion.com/reference/query-a-data-source
  - type: DataSourceTemplatesListAPI
    url: https://developers.notion.com/reference/list-data-source-templates
  - type: FileUploadCreateAPI
    url: https://developers.notion.com/reference/create-a-file-upload
  - type: FileUploadSendAPI
    url: https://developers.notion.com/reference/send-a-file-upload
  - type: FileUploadCompleteAPI
    url: https://developers.notion.com/reference/complete-a-file-upload
  - type: FileUploadRetrieveAPI
    url: https://developers.notion.com/reference/retrieve-a-file-upload
  - type: FileUploadsListAPI
    url: https://developers.notion.com/reference/list-file-uploads
  - type: TokenCreateAPI
    url: https://developers.notion.com/reference/create-a-token
  - type: TokenIntrospectAPI
    url: https://developers.notion.com/reference/introspect-token
  - type: TokenRefreshAPI
    url: https://developers.notion.com/reference/refresh-a-token
  - type: TokenRevokeAPI
    url: https://developers.notion.com/reference/revoke-token
  - type: GraphQL
    url: graphql/notion-graphql.md
name: Notion
tags:
- Collaboration
- Database
- Ideas
- Notes
- Productivity
- Project
- T1
- Task
- Wiki
- Workspace
tags_raw:
- Collaboration
- Database
- Ideas
- Notes
- Productivity
- Projects
- T1
- Tasks
- Wiki
- Workspace
type: Index
deliveryModel:
  model: open-core
  license: MIT
  open_source: true
  commercial: true
  callable_host: true
  label: Open core · an OSS project plus a commercial hosted product
  confidence: high
  source:
  - license
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://www.notion.so/images/meta/default.png
access: 3rd-Party
common:
- type: Website
  url: https://www.notion.com/
- type: IssueTracker
  url: https://github.com/makenotion/notion-sdk-js/issues
- type: Releases
  url: https://github.com/makenotion/notion-sdk-js/releases
- type: License
  name: MIT
  url: https://github.com/makenotion/notion-sdk-js/blob/main/LICENSE
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/notion/overview
- type: Packages
  url: packages/notion-packages.yml
- type: MCPServer
  url: mcp/notion-mcp.yml
- type: LLMsTxt
  url: llms/notion-llms.txt
- type: WellKnown
  url: well-known/notion-well-known.yml
- type: SecurityTxt
  url: well-known/notion-security.txt
- type: Overlay
  url: overlays/notion-openapi-overlay.yaml
- type: Conformance
  url: conformance/notion-conformance.yml
- type: ErrorCatalog
  url: errors/notion-error-codes.yml
- type: Lifecycle
  url: lifecycle/notion-lifecycle.yml
- type: Conventions
  url: conventions/notion-conventions.yml
- type: ChangeLog
  url: changelog/notion-changelog.yml
- type: CLI
  url: cli/notion-cli.yml
- type: DataModel
  url: data-model/notion-data-model.yml
- type: AgenticAccess
  url: agentic-access/notion-agentic-access.yml
- type: TrustCenter
  url: security/notion-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/notion-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/notion-domain-security.yml
- type: Authentication
  url: authentication/notion-authentication.yml
- type: Arazzo
  url: arazzo/notion-block-edit-cleanup-workflow.yml
  name: Notion Edit and Optionally Delete a Page Block
- type: Arazzo
  url: arazzo/notion-comment-thread-reply-workflow.yml
  name: Notion Reply to an Existing Comment Thread
- type: Arazzo
  url: arazzo/notion-create-database-page-content-workflow.yml
  name: Notion Create a Database, Seed a Page, and Add Content
- type: Arazzo
  url: arazzo/notion-create-page-read-children-workflow.yml
  name: Notion Create a Page and Read Back Its Content
- type: Arazzo
  url: arazzo/notion-data-source-sync-workflow.yml
  n

# --- truncated at 32 KB (43 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/notion/refs/heads/main/apis.yml

Work with this as data

Every provider 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 providers

9 MCP tools reach this
  • find_providersBrowse and filter every provider in the catalog.
  • get_provider_artifactsEvery artifact this provider publishes, grouped by type.
  • get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
  • get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
  • get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
  • get_provider_ratingPRO — composite, band, trend and facet scores.
  • 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 provider 
curl "https://apis.io/api/v1/providers/notion"
All providers 
curl "https://apis.io/api/v1/providers?limit=25"
Every operation they expose 
curl "https://apis.io/api/v1/providers/notion/operations?limit=25"
How their score was established 
curl "https://apis.io/api/v1/providers/notion/evidence"

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.