节点 / builtin / integration
Notion
Integrate with Notion to perform operations on databases, pages, and blocks.
此内容尚不支持你的语言。
Add rows to Notion databases, read and update pages, and append text, files or images to a page.
What it does
Section titled “What it does”The Notion node works on three kinds of things (Resource), each with its own Operation:
- Database: find the databases your integration can see (Get many, up to 10 at a time), or read one database’s columns and their types (Get schema).
- Page: add a page to a database (Create), read a page, change its properties, or move it to the trash (Delete). In a database, each row is a page.
- Block: add content to the end of a page (Create), or read the content of a page or block (Get, up to 100 blocks).
When you pick a Database, the Properties list shows that database’s columns, and the node turns each value into the right Notion type: text, number, checkbox, date, select (by option name), multi-select (a list of option names), URL, email or phone. Columns you leave empty, or names that do not match a column, are skipped.
Block → Create can also upload a file from an earlier node and add it to the page as a File or Image block.
Some operations do less than their name says:
- Page → Update only works on pages that sit in a database.
- Block → Update adds a new block with the new content at the end of the page or block; it does not change the existing one.
- Block → Delete always stops with an error: Notion blocks cannot be deleted from this node.
- Page → Search does not search your workspace at the moment and ends with a Notion error.
When to use it
Section titled “When to use it”- Save web pages, leads or AI summaries as rows of a Notion database.
- Mark a database row as done, or change its status, when something happens elsewhere.
- Append a daily log line, a heading and a list to a journal page.
- Attach a screenshot or a downloaded PDF to a Notion page.
To keep notes in local Markdown files instead, use Obsidian.
Inputs and settings
Section titled “Inputs and settings”| 设置项 | 类型 | 作用 |
|---|---|---|
| Credential (必填) | Credential | The Credential to use to make the request. |
11 个选项 · 选择“Resource and Operation”以查看其设置
Database · Get many 的设置
| 设置项 | 类型 | 作用 |
|---|---|---|
| Search Query | Text | Search query to filter databases. |
Database · Get schema 的设置
| 设置项 | 类型 | 作用 |
|---|---|---|
| Database (必填) | Choice (loaded from your account) | The Notion database to work with. |
Page · Create 的设置
| 设置项 | 类型 | 作用 |
|---|---|---|
| Database (必填) | Choice (loaded from your account) | The Notion database to work with. |
| Properties (必填) | Field list | The properties to set for the page. |
Page · Get 的设置
| 设置项 | 类型 | 作用 |
|---|---|---|
| Page (必填) | Choice (loaded from your account) | The Notion page to work with. |
Page · Update 的设置
| 设置项 | 类型 | 作用 |
|---|---|---|
| Page (必填) | Choice (loaded from your account) | The Notion page to work with. |
| Properties (必填) | Field list | The properties to update for the page. |
Page · Delete 的设置
| 设置项 | 类型 | 作用 |
|---|---|---|
| Page (必填) | Choice (loaded from your account) | The Notion page to work with. |
Page · Search 的设置
| 设置项 | 类型 | 作用 |
|---|---|---|
| Search Query (必填) | Text | Finds pages whose title contains this text. |
| Page Size | Number | Number of results to return (1-100). 默认值:100 |
Block · Create 的设置
| 设置项 | 类型 | 作用 |
|---|---|---|
| Block (必填) | Text | The ID of the block to work with. |
| Block Type | Choice | The type of block to create. File / Image upload the file attached to the incoming item ($binary). Options: Paragraph, Heading 1, Heading 2, Heading 3, Bulleted List, Numbered List, To-Do Item, File (from binary), Image (from binary). 默认值:Paragraph |
| Content | Text | The content for the block. |
| Binary Field | Text | Which $binary key on the incoming item holds the file. Used only for the File / Image block types. HTTP Request / Local File Read store under "data" by default. 默认值:data |
| Caption | Text | Optional caption shown under the File / Image block. |
Block · Get 的设置
| 设置项 | 类型 | 作用 |
|---|---|---|
| Block (必填) | Text | The ID of the block to work with. |
Block · Update 的设置
| 设置项 | 类型 | 作用 |
|---|---|---|
| Block (必填) | Text | The ID of the block to work with. |
| Block Type (必填) | Choice | The type of block to create. Options: Paragraph, Heading 1, Heading 2, Heading 3, Bulleted List, Numbered List, To-Do Item. |
| Content (必填) | Text | The content for the block. |
Block · Delete 的设置
| 设置项 | 类型 | 作用 |
|---|---|---|
| Block (必填) | Text | The ID of the block to work with. |
正在显示 Database · Get many 的设置
- Database and Page lists load from Notion once the credential is set. You can also type an id or use an expression. The id is the 32-character code in the page’s or database’s link, for example
https://www.notion.so/My-Tasks-1a2b3c...ends with the id. - Properties uses the column names exactly as they appear in Notion. Dates accept any date the browser understands, like
2026-09-10or2026-09-10T09:00:00. - Block is the id of the page (or block) to add content to or read from. A page id works here.
- For File (from binary) or Image (from binary), the file comes from the incoming item’s
$binarydata under Binary Field (databy default), as produced by Http Request, Screenshot Page or Local File Read. The file keeps its name and type. Content is not used for these two types.
Outputs
Section titled “Outputs”-
Output
- Page → Create, Get, Update and Delete return the page: its
id,url,properties,parentand timestamps. Property values are in Notion’s own format, for example a title underproperties.Name.title[0].plain_text. - Database → Get many returns one item per database; Get schema returns one database with its
properties(each column’s name and type). - Block → Create, Update and Get return
results, the list of blocks, plushas_morewhen there are more than 100.
Dependencies and credentials
Section titled “Dependencies and credentials”- Credential (connection, Bearer Token): required. See Connect Notion.
The credential is a Notion internal integration token, saved as a Bearer Token credential:
- In Notion, open Settings → Connections → Develop or manage integrations (notion.so/my-integrations) and create a new internal integration for your workspace.
- Copy its Internal Integration Secret and paste it as the token in a new credential. See Create a credential.
- Share each page or database you want to use with the integration: open it in Notion, then ⋯ → Connections → Connect to and pick your integration. Sharing a parent page also shares the pages inside it.
The node only sees what you shared. A database missing from the Database list usually means it is not shared yet.
Example workflow
Section titled “Example workflow”- A Context Menu trigger adds “Save to Notion” to the right-click menu.
- Get Page Metadata reads the page’s
titleandurl. - Notion, Page → Create, Database
Reading list, with PropertiesName={{ $input.title }},URL={{ $input.url }}andStatus=To read. - Notion, Block → Create, Block
{{ $input.id }}(the new page), Block TypeParagraph, ContentSaved from the browser.
Common issues
Section titled “Common issues”- “Notion API Error: Could not find database with ID… (object_not_found)”. The database or page is not shared with your integration, or the id is wrong. Connect the integration to it in Notion (⋯ → Connections).
- “Notion API Error: API token is invalid. (unauthorized)”. The token is wrong or the integration was deleted. Copy the secret again and update the credential.
- “Cannot determine database for page property conversion”. Page → Update was used on a page that is not in a database. Only database rows can be updated.
- “Notion file block: no file found on the incoming item under $binary.data…”. The previous node did not produce a file under Binary Field. Check the key, or add a node that downloads or creates the file.
- “Block deletion requires updating the parent block without including this block”. Block → Delete is not supported. Delete the block in Notion, or move the whole page to the trash with Page → Delete.
- The run is blocked in the web app. Notion runs through the browser extension. Install the extension and allow Notion for this workflow when asked, or run the workflow from the extension. See Running extension-only integrations in the web app.
Related nodes
Section titled “Related nodes”- Obsidian: notes in your local Obsidian vault.
- Airtable: another table-style database.
- Edit Fields: prepare values before sending them as Properties.
- Http Request: call Notion’s API for things this node does not cover, such as querying a database.