Notion Node

Interact with Notion databases, pages, blocks, and users.

Setup

  1. Go to notion.so/my-integrations
  2. Create an Internal Integration
  3. Copy token (secret_xxx…)
  4. Add a NOTION credential in Nodebase
  5. In Notion: open database → → Add connections → select your integration
The integration must be added to each database you want to access.

Output Key

All operations store output under: {{notion.operation}} {{notion.data}} {{notion.timestamp}}

Operations

Query Database

Fetch rows from a Notion database with optional filters.

  • Required: Database ID
  • Optional: Filter JSON, Sorts JSON, Page Size, Start Cursor
jsonFilter example
{"property": "Status", "select": {"equals": "Done"}}
jsonSorts example
[{"property": "Created", "direction": "descending"}]

Output: {{notion.data.results}} — array of page objects

Create Page in Database

Add a new row to a Notion database.

jsonProperties example (Name + Email columns)
{
  "Name": {
    "title": [{"text": {"content": "John Doe"}}]
  },
  "Email": {
    "email": "john@example.com"
  }
}

Output: {{notion.data.id}}, {{notion.data.url}}

Get Page

Fetch a page by ID. Output: {{notion.data.properties}}, {{notion.data.url}}

Update Page

Update properties of an existing page. Required: Page ID, Properties JSON (only changed fields).

Archive Page

Move a page to trash. Required: Page ID.

Search across all accessible pages and databases. Optional: query text, filter type (page/database/all).

Output: {{notion.data.results}}

Append Block Children

Add content blocks to a page. Block content can be plain text (auto-wrapped as a paragraph block) or a JSON array of block objects.

Get Block Children

Fetch all blocks inside a page or block.

Database & User Operations

GET_DATABASE, GET_USER, GET_USERS — fetch metadata about databases and workspace members.

Getting Database ID

From the Notion URL:

text
notion.so/workspace/MY-DATABASE-ID?v=viewId
                       ^^^^^^^^^^^^^^^^
Copy the 32-character hex string before ?v=
You can also use the Search operation to find databases by name and retrieve their IDs programmatically.