Actions16
Overview
The "Append Children" operation for the "Block" resource in this Notion Advanced node allows users to add one or more child blocks to an existing block within a Notion page or database. This is useful when you want to programmatically extend the content of a block by nesting additional blocks inside it, such as adding paragraphs, headings, lists, images, or other supported block types.
Common scenarios include:
- Adding new content sections under an existing heading.
- Appending list items to a bulleted or numbered list block.
- Embedding media or files as children of a container block.
- Building complex nested structures dynamically in Notion pages.
For example, you could append a paragraph and an image block as children to a toggle block to create collapsible content with text and visuals.
Properties
| Name | Meaning |
|---|---|
| Block ID | The unique identifier of the parent block to which new child blocks will be appended. |
| Blocks | A collection of blocks to append as children. Each block includes: - Type: The type of block to create (e.g., Paragraph, Heading 1, Bulleted List Item, To Do, Image, Code, Quote, etc.). - Content: Text, code, URL, or other content depending on block type. - Rich Text (JSON): Optional rich text content formatted as a JSON array. - Properties (JSON): Additional block properties like color, checked status, language, etc., provided as JSON. - Children (JSON): Optional nested child blocks as a JSON array. |
| Additional Fields | (Not applicable specifically for Append Children operation; present in general but not used here.) |
Output
The output is a JSON object representing the result of the append operation. It typically contains the updated block structure including the newly appended children. The exact structure matches Notion's API response for appending children to a block, which includes:
children: An array of the appended child blocks with their details.- Metadata about the block and its children count.
No binary data output is involved in this operation.
Dependencies
- Requires a valid Notion API authentication token configured in n8n credentials.
- Uses Notion's official API endpoints for block manipulation.
- Relies on utility functions for parsing and validating block inputs and formatting rich text.
Troubleshooting
Error: No blocks provided
Occurs if the "Blocks" property is empty or improperly formatted. Ensure at least one block is defined with correct JSON for properties and children if used.Invalid JSON in Properties or Children fields
If the JSON strings for block properties or children are malformed, the node will throw an error. Validate JSON syntax before input.Invalid Notion API credentials
The node checks credentials before execution. Make sure the API key/token is valid and has permissions to edit the target page/block.Unknown block type or invalid block structure
The node validates each block before sending. Use only supported block types and provide required fields accordingly.