Notion

What it does

The Notion node connects your flow to Notion, letting you read and write pages, query databases, and manage content blocks.

For example:

• Automatically create a row in your order-tracking database

• Log a customer note onto an existing page

Setup

Before using this node, you'll need a Notion credential connected:

1. Go to notion.so/my-integrations and create a new integration

2. Copy the Internal Integration Secret it generates

3. In Syncaut, add a new Notion credential using that secret

Important — don't skip this step:
Notion integrations can only see pages and databases that have been explicitly shared with them.

After creating your integration:

• Open the database or page you want to automate

• Click Share

• Add your integration by name

If you skip this:

• Every request will fail with a "not found" error

• Even if the ID is correct

This is the most common setup mistake.

Once connected, the credential will be available in any Notion node.

Configuration

The setup dialog has three steps:

1. Connect

• Choose a Step name

• Select the Notion credential

2. Action

Choose what you want to do:

Databases

• Get database

• Query database

Pages

• Create page

• Get page

• Update page

• Archive page

Content

• Append content blocks

• Get page content

Search

• Search workspace

3. Parameters

Fill in the required fields depending on the action.

Examples:

• Get database → Database ID

• Query database → Database ID, optional filter, sorts, page size

• Create page → Database or Page ID, optional title, properties, content blocks

• Update page → Page ID + properties JSON

• Append content blocks → Page/Block ID + blocks JSON

You can use:

• A simple form

• Or raw JSON (for advanced use cases)

Form vs JSON mode

You can switch between form and JSON mode in the Parameters step.

For Create page and Update page, you may need to match Notion’s property structure exactly.

Here are common examples:

• Title
  "Name": { "title": [{ "text": { "content": "..." } }] }

• Text
  "Notes": { "rich_text": [{ "text": { "content": "..." } }] }

• Number
  "Total": { "number": 123 }

• Select
  "Status": { "select": { "name": "Pending" } }

• Multi-select
  "Tags": { "multi_select": [{ "name": "vip" }] }

• Date
  "Due": { "date": { "start": "2026-06-17" } }

• Checkbox
  "Done": { "checkbox": true }

• URL
  "Link": { "url": "..." }

• Email
  "Email": { "email": "..." }

• Relation
  "Project": { "relation": [{ "id": "..." }] }

How to reference the output

The result is stored under your Step name.

Available fields:

• {{result.data}} → Raw Notion response

• {{result.action}} → The action performed

Replace result with your actual Step name.

Notes & troubleshooting

• Create page (title options)
  You can either:

  • Use Title (quick fill) + Title property name

  • Or define it manually in JSON

  If both are provided, they are merged.

• Parent type (Create page)

  • Default = Database

  • Set to Page if creating a sub-page

• Query database pagination

  • startCursor is not available in form mode

  • Use JSON mode for full pagination

• Restore archived page

  • Use Update page with:
    "archived": false

• Strict schema requirement
  Your JSON must exactly match:

  • Column names

  • Property types

  Otherwise, the request will fail (no silent errors).