Skip to content

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

FieldDescriptionNotes
ConnectionNotion connection to useRequired
Database IDThe ID of the Notion database to queryRequired. Supports templates
Filter (JSON)Notion filter objectOptional. JSON format, supports templates
Sort (JSON)Notion sort arrayOptional. JSON format
Max ResultsMaximum pages to returnDefault: 100

Output

Each result is a flattened page object:

FieldDescription
idNotion page ID
urlPage URL in Notion
created_timeISO timestamp of page creation
last_edited_timeISO timestamp of last edit
propertiesMap 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

FieldDescriptionNotes
ConnectionNotion connection to useRequired
Database IDParent database for the new pageRequired. Supports templates
PropertiesProperty name → value mappingRequired. 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 select with the given name
  • Status properties → wrapped as status with 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

FieldDescriptionNotes
ConnectionNotion connection to useRequired
Page IDThe ID of the page to updateRequired. Supports templates
PropertiesProperties to updateRequired. 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

FieldDescriptionNotes
ConnectionNotion connection to useRequired
Page IDThe ID of the page to archiveRequired. 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

FieldDescriptionNotes
ConnectionNotion connection to useRequired
Page IDThe ID of the page to retrieveRequired. 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.