Notion

Notion operations — create pages, query databases, update properties, and append content blocks via the Notion REST API.

Use Notion when you need to automate your workspace:

• Create new pages in a database from form submissions or webhook events
• Update page properties (status, assignee, dates) on existing records
• Query a database with filters to find matching pages
• Append content blocks to an existing page (notes, logs, summaries)

Connect a Notion node to an AI Agent Tools handle to let the agent create tasks, update records, or query your workspace.

Notion Account — required. Pick a Notion connection from the Connections page. Click Manage next to the account picker to add one — managed mode uses Tensorify's Notion public integration, so there's no token creation or copying on your side.

Whichever credential you use, Notion requires the target database or page to be shared with the integration (open the database in Notion → ⋯ → Connections → add it) before the API can access it.

The result (accessed as {{ notion.* }}) shape:

{
  "success": true,
  "id": "abc123-def456",
  "url": "https://www.notion.so/abc123def456",
  "results": [],
  "error": null
}

Each node run executes a single operation. Set Operation, then configure the fields shown for that operation.

Shown when operation is create_page:

Shown when operation is update_page:

Shown when operation is query_database:

Shown when operation is append_blocks:

If you'd rather manage credentials yourself instead of a connection, create an internal integration token and store it on the Environment Variables page:

Create a task in a Notion database from a webhook:

Webhook Trigger → Notion (create_page)

Notion settings:

• Operation: create_page
• Database ID: abc123def456789
• Properties:

  {
    "Name": { "title": [{ "text": { "content": "{{ webhook.body.title }}" } }] },
    "Status": { "select": { "name": "To Do" } }
  }
  

Access the result downstream:

{{ notion.success }}
{{ notion.url }}
{{ notion.id }}

Query a database and process results:

Manual Trigger → Notion (query_database) → Transform

Notion settings:

• Operation: query_database
• Database ID: abc123def456789
• Filter:

  {
    "property": "Status",
    "select": { "equals": "In Progress" }
  }
  

Iterate over results with {{ notion.results }}.

import webhook from @tensorify/webhook-trigger:4.0.0
import notion from @tensorify/notion:1.0.0

node trigger @tensorify/webhook-trigger:4.0.0 {
    path = "/tasks"
    method = "POST"
}

node create_page @tensorify/notion:1.0.0 {
    operation = "create_page"
    database_id = "abc123def456789"
    properties = "{\"Name\": {\"title\": [{\"text\": {\"content\": \"{{ webhook.body.title }}\"}}]}}"
}

trigger.payload -> create_page.input

Notion has a hidden On Error control output branch (error). Enable it via the "Error output handle" toggle at the bottom of the settings panel.

The error branch fires when the Notion API returns an error or the request fails at runtime. On the main path, failures are also reflected in {{ notion.success }} and {{ notion.error }} on the result output.

• Share with integration: The API cannot access databases or pages you have not explicitly connected to your integration in Notion.
• Property format: properties, filter, and children must use valid Notion API JSON — invalid structure causes API errors.
• Database ID vs Page ID: create_page and query_database use database_id; update_page and append_blocks use page_id.
• Check notion.success: The node completes on the main output even when the API call fails. Use an If node or the On Error branch to handle failures.
• Agent permissions: Restrict Allowed Operations (Agent) to prevent an AI agent from modifying records you want read-only.

• Connections — connect the Notion account the node runs as
• AI Agent — connect Notion as an agent tool
• Transform — shape query results for downstream nodes
• Webhook Trigger — trigger Notion updates from external events
• Environment Variables — fallback for self-managed NOTION_TOKEN