Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.notion.com/llms.txt

Use this file to discover all available pages before exploring further.

The Enterprise API can be used to manage Notion resources associated with your organization. Use the navigation on the left to find details for endpoints used in the API.
The Enterprise API is only available to organizations and workspaces that are actively on the enterprise plan.

​
Creating & managing tokens

Every request is authenticated with an organization bot token tied to your Notion organization. Organization owners can manage these tokens in the organization console, where they can create, edit, or revoke any active tokens.

​
Conventions

The base URL to send all API requests is https://app.notion.com/admin. HTTPS is required for all API requests. The Notion API follows RESTful conventions when possible, with most operations performed via GET, POST, PATCH, and DELETE requests on page and database resources. Request and response bodies are encoded as JSON.

​
Code samples

Samples requests and responses are shown for each endpoint. Requests are shown using cURL. These samples make it easy to copy, paste, and modify as you build your connection.

​
Pagination

Endpoints that return lists of objects support cursor-based pagination requests. By default, Notion returns ten items per API call. If the number of items in a response from a support endpoint exceeds the default, then you can use pagination to request a specific set of the results and/or to limit the number of returned items.