Notion API official
Notion is the all-in-one workspace that helps you organize, collaborate, and manage your projects across teams and devices. Now, with the Notion API, you can unlock even greater potential by connecting Notion to the tools you already use. Here's what you can achieve with the Notion API: Supercharge your workflows: Automate repetitive tasks and streamline processes by integrating Notion with your…
Notion API official endpoints
| Method | Endpoint | Description |
|---|---|---|
| Users | ||
| GET |
List all users /v1/users |
Returns a paginated list of user objects for a workspace |
| GET |
Retrieve a user /v1/users/{id} |
Retrieve a user object using the ID specified in the request path. |
| GET |
Retrieve bot's user info /v1/users/me |
Retrieve bot's user info |
| Databases | ||
| GET |
Retrieve a database /v1/databases/{id} |
Retrieves a database object using the ID specified in the request path. |
| POST |
Create a database /v1/databases/ |
Create a database |
| POST |
Query a database /v1/databases/{id}/query |
Query a database |
| PATCH |
Update a database /v1/databases/{id} |
Update a database |
| Pages | ||
| GET |
Retrieve a Page /v1/pages/{id} |
Retrieves a Page object using the ID in the request path. This endpoint exposes page properties, not page content. |
| POST |
Create a Page /v1/pages/ |
Create a Page |
| DELETE |
Delete a Page /v1/blocks/{id} |
Delete a Page |
| PATCH |
Update Page properties /v1/pages/{id} |
Updates a page by setting the values of any properties specified in the JSON body of the request. Properties not updated via parameters will remain unchanged. |
| Blocks | ||
| GET |
Retrieve a block /v1/blocks/{id} |
Retrieve a block |
| GET |
Retrieve block children /v1/blocks/{id}/children |
Retrieve block children |
| PATCH |
Append block children /v1/blocks/{id}/children |
Append block children |
| PATCH |
Update a block /v1/blocks/{id} |
This endpoint allows you to update block content. [See Full Documentation](https://developers.notion.com/reference/update-a-block) |
| Search | ||
| POST |
Search /v1/search |
|
| Comments | ||
| POST |
Add comment to page /v1/comments |
Add comment to page |
| GET |
Retrieve comments /v1/comments |
Retrieve a user object using the ID specified in the request path. |
Notion API official pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|