Connectors
Productivity & Project Management
Notion
Connected workspace: pages, databases, blocks, and comment updates
Notion API referenceAPI checked August 18, 2026
- Signs in with
- API token
- Runs on
- Cloud or On-Prem Worker
- Operations
- 45
- Ready-made triggers
- 0
Connect Notion
- In Neblex open Connect › Connections and click New Connection.
- Search for Notion and give the connection a clear name.
- Fill in the fields. Secret values are encrypted and never shown again.
- Click Test, then Create Connection.
| Field | What to enter |
|---|---|
| Integration tokenRequiredSecret |
Use it in a flow
- Open a flow, open the node library and search for Notion.
- Drag it onto the canvas and choose an Operation and your connection.
- Map the operation's fields from earlier steps, or click Map with Matt.
- Use Test this step to see what it returns, then save.
To start a flow from Notion without a ready-made trigger: a Poll for changes trigger can check one of its list operations on a schedule and pass on only what is new; if Notion can send webhooks, a Webhook trigger receives them at its own URL.
Operations
45 operations in 12 groups. Each one is a step you can add to a flow.
Block5
Children blockget_block_children | GET | |
Children blockpatch_block_children | PATCH | |
Delete blockdelete_a_block | DELETE | |
Get blockretrieve_a_block | GET | |
Update blockupdate_a_block | PATCH |
Comment5
Create commentcreate_a_comment | POST | Creates a comment in a page or existing discussion thread. |
Delete a commentdelete_comment | DELETE | Delete a comment by id. |
Get a commentget_comment | GET | Read one comment by id. |
List commentsretrieve_a_comment | GET | Retrieves a list of un-resolved Comment objects from a page or block. |
Update a commentupdate_comment | PATCH | Edit a comment's rich text (or markdown). |
Data Source5
Create a data sourcecreate_a_data_source | POST | Create a new data source (database) |
List templates in a data sourcelist_data_source_templates | GET | List available templates for a data source |
Query a data sourcequery_data_source | POST | Query a data source (database) using filters and sorts |
Retrieve a data sourceretrieve_a_data_source | GET | Retrieve metadata and schema for a data source |
Update a data sourceupdate_a_data_source | PATCH | Update properties of a data source |
Database3
Create a databasecreate_a_database | POST | Create a database (with its initial data source) under a parent page. |
Retrieve a databaseretrieve_a_database | GET | Retrieves a database object using the ID specified. |
Update a databaseupdate_a_database | PATCH | Update a database's container fields (title, icon, lock, trash). |
Emoji1
List custom emojislist_custom_emojis | GET | Page through the workspace's custom emojis. |
File5
Complete a file uploadcomplete_file_upload | POST | Complete a multi-part upload after all parts are sent. |
Create a file uploadcreate_file_upload | POST | Open a file upload (single part, multi part or external url mode). |
Get a file uploadget_file_upload | GET | Read a file upload's status by id. |
List file uploadslist_file_uploads | GET | Page through the workspace's file uploads. |
Send file contentsend_file_upload | POST | Send the file bytes for an open upload (one part per call in multi part mode). |
Meeting Notes1
Query meeting notesquery_meeting_notes | POST | Query AI meeting-note blocks across the workspace. |
Page7
Create pagepost_page | POST | |
Get pageretrieve_a_page | GET | |
Get pageretrieve_a_page_property | GET | |
Move a pagemove_page | POST | Move a page to a different parent location |
Retrieve a page as Markdownretrieve_page_markdown | GET | Retrieve the full content of a Notion page rendered as enhanced Markdown. |
Update a page's content as Markdownupdate_page_markdown | PATCH | Update the content of a Notion page using enhanced Markdown. |
Update pagepatch_page | PATCH |
Search1
Search searchpost_search | POST |
Task1
Get an async taskget_async_task | GET | Poll an async task's status by id (returned by allow async operations). |
User3
Get userget_user | GET | |
List usersget_users | GET | List all users |
Me userget_self | GET |
View8
Create a viewcreate_view | POST | Create a view (full typed view JSON as the body). |
Create a view querycreate_view_query | POST | Run a view's query (async result set). |
Delete a viewdelete_view | DELETE | Delete a view by id. |
Delete a view querydelete_view_query | DELETE | Delete a view query and its results. |
Get a viewget_view | GET | Read one view by id. |
Get view query resultsget_view_query_results | GET | Page through a view query's results. |
List viewslist_views | GET | Page through the views of a database or data source. |
Update a viewupdate_view | PATCH | Update a view (typed view fields as the body). |