Notion
Notion nodes let you interact with Notion databases and pages in your workflows. You can query databases, create new pages, and update existing page properties.
All Notion nodes require a Notion connection configured with an Internal Integration Token.
Query Database
Query a Notion database to retrieve matching pages. Supports filtering, sorting, and pagination.
Configuration
| Field | Description | Notes |
|---|---|---|
| Connection | Notion connection to use | Required |
| Database ID | The ID of the Notion database to query | Required. Supports templates |
| Filter (JSON) | Notion filter object | Optional. JSON format, supports templates |
| Sort (JSON) | Notion sort array | Optional. JSON format |
| Max Results | Maximum pages to return | Default: 100 |
Output
Each result is a flattened page object:
| Field | Description |
|---|---|
id | Notion page ID |
url | Page URL in Notion |
created_time | ISO timestamp of page creation |
last_edited_time | ISO timestamp of last edit |
properties | Map of property name → simplified value |
Properties are automatically flattened from Notion's verbose format to simple values (e.g., title text, select name, number value).
Filter Example
json{
"property": "Status",
"select": {
"equals": "In Progress"
}
}
Sort Example
json
[
{
"property": "Created",
"direction": "descending"
}
]Create Page
Create a new page (record) in a Notion database. Can be used standalone (creates a single page) or with upstream data (creates one page per input item).
Configuration
| Field | Description | Notes |
|---|---|---|
| Connection | Notion connection to use | Required |
| Database ID | Parent database for the new page | Required. Supports templates |
| Properties | Property name → value mapping | Required. Key-value pairs |
Property Value Handling
Property values are automatically wrapped in the correct Notion format based on the database schema. The node detects each property's type and formats the value accordingly:
- Title properties (e.g., "Name") → wrapped as
title - Rich text properties → wrapped as
rich_text - Number properties → wrapped as
number - Select properties → wrapped as
selectwith the given name - Status properties → wrapped as
statuswith the given name - Checkbox properties → wrapped as
checkbox - Date properties → wrapped as
date - URL/Email/Phone properties → wrapped in their respective formats
You just need to enter the plain value (e.g., "In Progress" for a Status field) — the node handles the Notion API formatting automatically.
For explicit control, you can pass a Notion property object directly (with a type key).
Standalone vs Streaming
- Without upstream data: Creates a single page using the property values from the configuration.
- With upstream data: Creates one page per input item. Property values can reference fields from the input items.
Output
Returns the created page object with id, url, created_time, and flattened properties.
Update Page
Update properties of an existing Notion page. Only the specified properties are changed. Can be used standalone or with upstream data.
Configuration
| Field | Description | Notes |
|---|---|---|
| Connection | Notion connection to use | Required |
| Page ID | The ID of the page to update | Required. Supports templates |
| Properties | Properties to update | Required. Key-value pairs |
Output
Returns the updated page object with id, url, last_edited_time, and flattened properties.
Archive Page
Archive (soft-delete) a Notion page. Archived pages are hidden from the workspace but not permanently deleted — they can be restored via the Notion UI. Can be used standalone or with upstream data.
Configuration
| Field | Description | Notes |
|---|---|---|
| Connection | Notion connection to use | Required |
| Page ID | The ID of the page to archive | Required. Supports templates |
Output
Returns the archived page object with id, url, last_edited_time, and flattened properties.
Get Page
Retrieve a single Notion page by its ID. Returns the full flattened page object including all properties. Can be used standalone or with upstream data.
Configuration
| Field | Description | Notes |
|---|---|---|
| Connection | Notion connection to use | Required |
| Page ID | The ID of the page to retrieve | Required. Supports templates |
Output
Returns the page object with id, url, created_time, last_edited_time, and flattened properties.
Streaming Support
All Notion nodes support streaming:
- Query Database streams results as they are fetched (yields pages from each API response)
- Create Page creates one page per streaming input item (or a single page if no input is connected)
- Update Page updates one page per streaming input item (or a single page if no input is connected)
- Archive Page archives one page per streaming input item (or a single page if no input is connected)
- Get Page retrieves one page per streaming input item (or a single page if no input is connected)
Finding Database and Page IDs
Open a database or page in Notion and look at the URL. The 32-character hex string after the workspace name is the ID. For example, in https://notion.so/myworkspace/a1b2c3d4e5f6..., the ID is a1b2c3d4e5f6....
For inline databases (embedded in a page), the URL shows the page ID, not the database ID. Click the ... menu on the database → Open as full page or Copy link to get the correct database ID.