- Support
- Integrations
- Notion
Notion
Productivity integration · 13 node(s).
00Overview
Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.
01Connecting Notion
Add your credentials as a Flomation environment secret, then pick them in each node. The connection fields are:
| Field | Type | Details | |
|---|---|---|---|
| Notion Integration Token | secret | Required | ntn_... |
Pick an Environment on your flow (Flow Settings → Environment) so the secret resolves. Secret fields never show the value — they reference ${secrets.your_secret}.
02Add
Notion Add Comment
notion/add_comment · Action
Add a comment to a Notion page or discussion thread
| Field | Type | Details | |
|---|---|---|---|
| Page ID | string | Page to comment on | |
| Discussion Thread ID | string | Reply to existing discussion (optional) | |
| Comment Text | text | Required |
Returns: tool_result, comment_id, success, error
03Append
Notion Append Content
notion/append_block_children · Action
Append content blocks to a Notion page or block
| Field | Type | Details | |
|---|---|---|---|
| Block or Page ID | string | Required | |
| Text Content | text | Text to append as a paragraph | |
| Blocks (JSON array) | text | Advanced: raw Notion block objects |
Returns: tool_result, success, error
04Create
Notion Create Page
notion/create_page · Action
Create a new page in a Notion database or as a child of another page
| Field | Type | Details | |
|---|---|---|---|
| Parent ID (database or page) | string | Required | |
| Parent Type | string | Required | choices: Database, Page |
| Page Title | string | Required | |
| Page Content (Markdown-style text) | text | ||
| Additional Properties (JSON) | text | {"Status": {"select": {"name": "In Progress"}}} |
Returns: tool_result, page_id, url, success, error
05Delete
Notion Delete Block
notion/delete_block · Action
Delete (archive) a block from a Notion page
| Field | Type | Details | |
|---|---|---|---|
| Block ID | string | Required |
Returns: tool_result, success, error
06Get
Notion Get Block Children
notion/get_block_children · Action
Read the content blocks of a Notion page or block
| Field | Type | Details | |
|---|---|---|---|
| Block or Page ID | string | Required | |
| Results (default 50, max 100) | string |
Returns: tool_result, blocks, block_ids, count, success, error
Notion Get Database
notion/get_database · Action
Retrieve a Notion database schema and metadata
| Field | Type | Details | |
|---|---|---|---|
| Database ID | string | Required |
Returns: tool_result, title, url, properties, data, success, error
Notion Get Page
notion/get_page · Action
Retrieve a Notion page's properties by ID
| Field | Type | Details | |
|---|---|---|---|
| Page ID | string | Required |
Returns: tool_result, title, url, properties, data, success, error
07List
Notion List Comments
notion/list_comments · Action
List comments on a Notion page or block
| Field | Type | Details | |
|---|---|---|---|
| Block or Page ID | string | Required |
Returns: tool_result, comments, count, success, error
Notion List Databases
notion/list_databases · Action
List all databases shared with the integration
Returns: tool_result, databases, count, success, error
08Query
Notion Query Database
notion/query_database · Action
Query a Notion database with optional filters and sorts
| Field | Type | Details | |
|---|---|---|---|
| Database ID | string | Required | |
| Filter (JSON) | text | {"property": "Status", "select": {"equals": "Done"}} | |
| Sorts (JSON array) | text | [{"property": "Created", "direction": "descending"}] | |
| Results (default 20, max 100) | string |
Returns: tool_result, results, count, success, error
09Search
Notion Search
notion/search · Action
Search across all pages and databases in a Notion workspace
| Field | Type | Details | |
|---|---|---|---|
| Search Query | string | Required | |
| Filter Type | string | choices: All, Pages Only, Databases Only | |
| Results (default 10, max 100) | string |
Returns: tool_result, results, count, success, error
10Update
Notion Update Block
notion/update_block · Action
Edit a Notion block in place by its ID (rewrite its text or set raw fields)
| Field | Type | Details | |
|---|---|---|---|
| Block ID | string | Required | |
| New text content | text | Rewrites a text block's content | |
| Block body (JSON) | text | Advanced: raw Notion PATCH body |
Returns: tool_result, block, success, error
Notion Update Page
notion/update_page · Action
Update properties of an existing Notion page
| Field | Type | Details | |
|---|---|---|---|
| Page ID | string | Required | |
| Properties (JSON) | text | Required | {"Status": {"select": {"name": "Done"}}} |
| Archive Page | boolean |
Returns: tool_result, url, success, error
11Notes & Limitations
Behaviours and constraints worth knowing before you build with these nodes.
- The integration can only see pages and databases that have been explicitly shared with it in Notion, so any newly created page or database must be connected to the integration before these nodes can read or write it.
- Search and Query Database draw from an index that updates with a short delay, so pages created or edited moments earlier may not appear in their results immediately.
- Deleting a block archives it to the workspace trash rather than removing it permanently, leaving the content recoverable in Notion for a limited time afterwards.
- List-style actions such as Query Database and Get Block Children return results in pages of up to 100 items, so large pages or databases require paging through several requests to retrieve everything.
- Rate limits average roughly three requests per second per integration, so high-volume flows may be throttled and are best spaced out to avoid failures.