Skip to main content
The Admin 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 Admin 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://api.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

List endpoints that paginate use cursor-based pagination. Some endpoints use a fixed page size; endpoints that accept page_size document its default and maximum. Pass a returned next_cursor as start_cursor to request the next page.