Notion API

Number of APIs: 19

Hello and welcome!

To make use of this API collection collection as it's written, please duplicate this database template.

Under the Variables tab, add your environment variables to start making requests. You will need to create an integration to retrieve an API token. You will also need additional values, such as a database ID and page ID, which can be found in your Notion workspace or from the database template mentioned above.

For our full documentation, including sample integrations and guides, visit developers.notion.com.

Please note: Pages that are parented by a database must have the same properties as the parent database. If you are not using the database template provided, the request body for the page endpoints included in this collection should be updated to match the properties in the parent database being used. See documentation for Creating a page for more information.

To learn more about creating an access token, see our official documentation and read our Authorization guide.

Need more help? Join our developer community on Slack.

  1. Pages - Create a page with content POST https://api.notion.com/v1/pages/

  2. Pages - Retrieve a page GET https://api.notion.com/v1/pages/:id

  3. Users - Retrieve a user GET https://api.notion.com/v1/users/:id

  4. Users - List all users GET https://api.notion.com/v1/users

  5. Users - Retrieve your token’s bot user GET https://api.notion.com/v1/users/me

  6. Databases - Retrieve a database GET https://api.notion.com/v1/databases/:id

  7. Databases - Filter a database POST https://api.notion.com/v1/databases/:id/query

  8. Databases - Create a database POST https://api.notion.com/v1/databases/

  9. Blocks - Retrieve block children GET https://api.notion.com/v1/blocks/:id/children?page_size=100

  10. Blocks - Append block children PATCH https://api.notion.com/v1/blocks/:id/children