Notion AI Tool icon

Notion AI Tool

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

Overview

This node operation "Add Content to Page" allows users to append new content blocks—such as paragraphs, headings, lists, quotes, and code blocks—to an existing Notion page. The content is provided in natural language or markdown-like syntax, and the node automatically structures it into appropriate Notion block types.

This operation is beneficial when you want to programmatically enrich or update existing Notion pages with additional information without overwriting the current content. For example, you could use it to add meeting notes, task lists, or summaries generated by AI to a project documentation page.

Practical example:

  • Append a new section with a heading and bullet points summarizing recent project updates.
  • Add a quote block or code snippet to an existing technical documentation page.

Properties

Name Meaning
Content The content to add. Use natural language or markdown-like syntax; the node converts it into structured blocks such as headings, paragraphs, lists, quotes, and code blocks. Example input: # Heading\nParagraph text\n- List item
Target Page ID The ID or URL of the existing Notion page where the content will be appended. This is required.
Additional Options A collection of optional settings:
• Icon: Emoji icon for the page (e.g., 📝, 🎯, 📊)
• Cover Image URL: URL of cover image for the page
• Return Full Content: Boolean to decide whether to return full page content or just metadata
• Max Results: Maximum number of results to return (1-100) — not directly relevant for this operation but part of shared options

Output

The output JSON contains the following fields:

  • pageId: The resolved ID of the target page where content was added.
  • blocksAdded: Number of content blocks successfully appended.
  • message: A human-readable message confirming how many blocks were added.
  • result: The raw response from the Notion API PATCH request that appended the blocks.

No binary data output is produced by this operation.

Dependencies

  • Requires a valid Notion API key credential configured in n8n to authenticate API requests.
  • Uses Notion's official API endpoints to patch content blocks on pages.
  • No other external services are needed.

Troubleshooting

  • Error: "No valid content blocks found to add"
    This occurs if the provided content string does not parse into any recognizable Notion blocks. Ensure your content includes supported markdown-like syntax or plain text lines.

  • Invalid Notion API credentials
    The node validates credentials before execution. Make sure your API key has sufficient permissions to modify pages.

  • Invalid Target Page ID
    If the page ID or URL is incorrect or inaccessible, the API call will fail. Verify the page identifier is correct and accessible by the API key.

  • API Rate Limits or Network Issues
    If the Notion API returns rate limit errors or network timeouts, retry after some delay or check connectivity.

Links and References

Discussion