Actions16
Overview
The node provides advanced integration with Notion, focusing on comprehensive block management within Notion pages. Specifically, the Block - Update operation allows users to update a single block's content and properties in Notion by specifying the block ID and new block data.
This operation is useful when you want to programmatically modify existing blocks in a Notion page, such as changing text content, updating formatting, or adjusting block-specific properties (e.g., toggling checkboxes, changing colors). For example, you could update a paragraph block's text or change the language of a code block.
Properties
| Name | Meaning |
|---|---|
| Block ID | The unique identifier of the block to update. |
| Additional Fields | Not applicable for this operation (no additional fields defined here). |
| Blocks | A collection containing exactly one block object to update, including: |
| - Type: The type of the block (e.g., paragraph, heading_1, to_do, code, etc.). | |
| - Content: The textual or relevant content of the block (e.g., text, URL, code snippet). | |
| - Rich Text (JSON): Rich text content formatted as a JSON array with styling information. | |
| - Properties (JSON): Block-specific properties such as color, checked state, language, etc. | |
| - Children (JSON): Optional child blocks as a JSON array (if applicable). |
Output
The output is the updated block object returned from the Notion API after the PATCH request. It contains the full block structure reflecting the changes made, including updated content, properties, and metadata.
No binary data output is involved in this operation.
Dependencies
- Requires a valid Notion API authentication token configured in n8n credentials.
- Uses Notion REST API endpoints to perform block updates.
- Relies on utility functions for parsing rich text input, converting block input into Notion API format, and validating block structure before sending requests.
Troubleshooting
Error: No block data provided for update
Occurs if the "Blocks" property is empty or not properly structured. Ensure that exactly one block object with valid data is provided.Invalid JSON in Properties or Rich Text
The node expects JSON strings for block properties and rich text. Malformed JSON will cause errors. Validate JSON syntax before input.Invalid Block Type or Content
If the block type or content does not conform to Notion API requirements, validation will fail. Use supported block types and formats.Authentication Errors
If the Notion API credentials are invalid or expired, the node will throw an authentication error. Verify and refresh your API key/token.