Notion

Authentication

Helios OAuth App (Recommended)

The Helios OAuth app is a full-featured integration that can be used to access all Notion workspaces. It requires the OAuth flow to be completed.

Permissions

The Helios OAuth app requires the following permissions:

• Read, Update and Insert Content
• Read and Insert Comments
• Read user information including email addresses

Internal Integration

An internal integration in Notion only has access to the workspace it is created in. This type of integration can be used without the OAuth flow directly with a secret.

Learn more about internal integrations in the Notion documentation.

BYO OAuth App (Public Integration)

If you want more granular control over the integration itself, you can create a custom OAuth app in Notion. However, this requires additional setup and is not recommended for most users.

Learn more about public integrations in the Notion documentation.

Functionality

The Notion integration lets your workflows read, create, update and search content inside a Notion workspace without writing custom code.

Typical use-cases include:

• Create database pages - add new rows to a database when an event happens in another service.
• Update page properties - keep Notion dashboards in sync with external data sources.
• Query databases - pull structured information out of Notion and pass it downstream in the workflow.
• Retrieve or append blocks - fetch the full page content or add text, headings, to-dos, images and more.
• Search workspace - quickly locate pages or databases by keyword.
• Comment on pages - add comments to pages.

As Trigger Node

Trigger node allows you to use the webhooks from notion to trigger your workflows. You can find the webhooks that Notion sends in the Notion Webhook Reference

The filter prompt in the trigger node is used to filter the webhooks with natural language prompt. For example, you can filter the webhooks to only trigger when a new page is created in a specific database or when a user comments on a page.

As Integration Node

When placed as an integration node, the Notion node lets you perform actions against pages, databases, blocks and more. All the public API operations are supported.

See what operations are supported in the Notion API Reference.

Outputs

Depending on the operation the node performs, it returns one of the standard Notion API payloads. You can check the output payloads of different operations in the Notion API Reference.

Example: If the node created a comment, the output value would be:

{
  "object": "comment",
  "id": "b52b8ed6-e029-4707-a671-832549c09de3",
  "parent": {
    "type": "page_id",
    "page_id": "5c6a2821-6bb1-4a7e-b6e1-c50111515c3d"
  },
  "discussion_id": "f1407351-36f5-4c49-a13c-49f8ba11776d",
  "created_time": "2022-07-15T20:53:00.000Z",
  "last_edited_time": "2022-07-15T20:53:00.000Z",
  "created_by": {
    "object": "user",
    "id": "067dee40-6ebd-496f-b446-093c715fb5ec"
  },
  "rich_text": [
    {
      "type": "text",
      "text": {
        "content": "Hello world",
        "link": null
      },
      "annotations": {
        "bold": false,
        "italic": false,
        "strikethrough": false,
        "underline": false,
        "code": false,
        "color": "default"
      },
      "plain_text": "Hello world",
      "href": null
    }
  ],
  "attachments": [
    {
      "category": "image",
      "file": {
        "url": "https://s3.us-west-2.amazonaws.com/...",
        "expiry_time": "2025-06-10T21:58:51.599Z"
      }
    }
  ],
  "display_name": {
    "type": "integration",
    "resolved_name": "Public Integration"
  }
}

To reference the output in other nodes, you can use the [[nodes["notion"].output]] syntax in prompts.

Limitations

The Notion public API is still evolving. Keep the following constraints in mind when designing workflows:

• Rate limits - The node automatically respects the per-second limit but high-volume jobs may require batching.
• Permissions - the integration token can access only the pages and databases that have been explicitly shared with it.

✅ What you can do

All of the Notion public API operations are supported which include but are not limited to:

• Add or update content in any shared database or page.
• Query databases with complex filter and sort combinations.
• Append rich-text, headings, to-dos, images, code blocks and more.
• Migrate content by iterating over databases and writing to external systems.
• Build dashboards that stay in sync by periodically updating Notion properties.

Read more about the endpoints and their capabilities in the Notion API Reference.

❌ What you can't do

• Access pages that have not been explicitly shared with the integration.
• Share pages with other users via the integration.
• Respond to discussions on pages. Comments are only allowed at page level.