Notion

About Notion

Notion provides a REST API for connecting external tools and automation scripts to a Notion workspace, allowing developers to read, create, and update pages, databases, users, and comments. The API supports three authentication models: internal connections, which use a static token scoped to a single workspace for team-owned automations; public connections, which use OAuth 2.0 and can be installed across multiple workspaces or listed on a Marketplace after security review; and personal access tokens, user-scoped static tokens for scripts, CLI workflows, and Workers that act on behalf of the token creator.

Each connection or token is configured with capabilities that control what it can access, including pages, databases, database views, data sources, file uploads, comments, content search, and user profiles. Content access is granted differently depending on connection type: internal connections get access through the Developer portal or by having workspace members share pages, public connections use an OAuth page picker during authorization, and personal access tokens inherit the creator's existing Notion permissions.

The API also supports webhooks, letting a connection subscribe to real-time events such as page updates, property changes, and new comments instead of polling. This is intended for developers building internal dashboards, syncing data, automating workflows, or creating apps and tools that integrate with Notion workspaces.

Key features

• REST API to read, create, and update pages, databases, users, and comments
• Three authentication models: internal connections, public connections (OAuth 2.0), and personal access tokens
• Webhook subscriptions for real-time events like page updates and new comments
• Granular capabilities configuration (read/insert content, comments, users, file uploads)
• Marketplace listing for public connections after Notion security review
• Official Notion SDK for JavaScript

Frequently asked questions