Integrate with Notion
Last verified: November 12, 2026
100% uptime: the documentation responded in 5 of 5 checks over the last 30 days. Median response time: 618 ms.
From Notion's OpenAPI specification (version 1.0.0), spec updated March 6, 2023, via APIs.guru.
Hello and welcome! To make use of this API collection collection as it's written, please duplicate this database template. Create an integration to retrieve an API token, add your database and page ID's as variables in the collection, and start making your requests! For our full documentation, including sample integrations and guides, visit developers.notion.com Need more help? Join our developer community on Slack
https://api.notion.com| Method | Path | What it does |
|---|---|---|
| GET | /v1/blocks/{id} | Retrieve a block |
| PATCH | /v1/blocks/{id} | Update a block |
| DELETE | /v1/blocks/{id} | Delete a block |
| GET | /v1/blocks/{id}/children | Retrieve block children |
| PATCH | /v1/blocks/{id}/children | Append block children |
| GET | /v1/comments | Retrieve comments |
| GET | /v1/databases/{id} | Retrieve a database |
| PATCH | /v1/databases/{id} | Update a database |
| POST | /v1/databases/{id}/query | Query a database |
| GET | /v1/pages/{id} | Retrieve a Page |
| PATCH | /v1/pages/{id} | Update Page properties |
| GET | /v1/pages/{page_id}/properties/{property_id} | Retrieve a Page Property Item |
| GET | /v1/users/{id} | Retrieve a user |