The reference is your key to a comprehensive understanding of the Notion API.
Integrations use the API to access Notion's pages, databases, and users. Integrations can connect services to Notion and build interactive experiences for users within Notion. Using the navigation on the left, you'll find details for each endpoint and type of object used in the API.
If this is your first look at the Notion API, we recommend beginning with the Getting started guide.
The base URL to send all API requests is
https://api.notion.com. HTTPS is required for all API requests.
The Notion API follows RESTful conventions when possible, with most operations performed via
DELETE requests on page and database resources. Request and response bodies are encoded as JSON.
- Top-level resources have an
"object"property. This property can be used to determine the type of the resource (e.g.
- Top-level resources are addressable by a UUIDv4
"id"property. You may omit dashes from the ID when making requests to the API, e.g. when copying the ID from a Notion URL.
- Property names are in
- Temporal values (dates and datetimes) are encoded in ISO 8601 strings. Datetimes will include the time value (
2020-08-12T02:12:33.231Z) while dates will include only the date (
- The Notion API does not support empty strings. To unset a string value for properties like a
urlProperty value object, for example, use an explicit
Notion SDKs are open source projects that you can install to easily start building. You may also choose any other language or library that allows you to make HTTP requests.