Notion AI Tool

AI-powered tool for creating and managing Notion content. Designed for use with AI Agent Nodes.

Actions6

Overview

The "Add Content to Page" operation of the Notion AI Tool node allows users to append new content blocks—such as paragraphs, headings, lists, quotes, images, code blocks, and more—to an existing Notion page. Users provide natural language or markdown-like text input, and the node uses AI-powered parsing to structure this input into appropriate Notion block types automatically.

This operation is beneficial when you want to enrich or update existing Notion pages dynamically without manually formatting each block. For example, you can add meeting notes, project updates, task lists, or rich media content programmatically by simply providing plain text or markdown-style content.

Practical examples:

  • Append a summary paragraph and bullet points to a project status page.
  • Add a quote block and an image to a knowledge base article.
  • Insert code snippets or equations into a technical documentation page.

Properties

Name Meaning
Target Page ID The ID or URL of the existing Notion page where the new content will be appended. This identifies the page to modify.
Content The textual content to add to the page. Use natural language or markdown-like syntax; the AI will parse and convert it into structured Notion blocks such as headings, paragraphs, lists, quotes, images, code, etc.
Additional Options Optional settings for the operation:
• Icon: Emoji icon to associate with the page (e.g., 📝, 🎯, 📊).
• Cover Image URL: URL of a cover image for the page.
• Max Results: Maximum number of results to return (not directly relevant here but part of options).

Output

The output JSON array contains objects representing the result of adding content to each processed input item. Each object includes:

  • operation: The string "addContentToPage".
  • success: Boolean indicating if the operation succeeded.
  • pageId: The resolved ID of the target Notion page.
  • blocksAdded: Number of content blocks successfully added to the page.
  • message: A human-readable message summarizing the action, e.g., "Added 5 content blocks to page".
  • result: The raw response from the Notion API PATCH request that appended the blocks, containing details about the updated page blocks.

If the operation fails and "continue on fail" is enabled, the output will include an error message and success: false.

The node does not output binary data for this operation.

Dependencies

  • Requires valid Notion API credentials configured in n8n to authenticate requests.
  • Relies on the Notion API to resolve page IDs and append content blocks.
  • Uses internal utility functions to parse natural language/markdown content into Notion block structures.
  • No additional external services beyond Notion API are required.

Troubleshooting

  • Invalid Notion API credentials: The node throws an error if credentials are missing or invalid. Ensure your API key/token is correctly set up in n8n.
  • No valid content blocks found: If the provided content cannot be parsed into any Notion blocks, the node will throw an error. Verify that the content is non-empty and formatted in supported markdown or natural language style.
  • Incorrect Target Page ID: Providing an invalid or inaccessible page ID or URL will cause the operation to fail. Confirm the page exists and the API token has access rights.
  • API rate limits or network issues: Temporary failures may occur due to Notion API limits or connectivity problems. Retrying or enabling "continue on fail" can help mitigate these.
  • Malformed markdown or unsupported tags: Complex or malformed markdown might not parse correctly. Simplify content or use supported markdown features.

Links and References

Discussion