Notion Advanced

Overview

The node "Notion Advanced" provides comprehensive integration with the Notion API, enabling users to manage Notion pages, blocks, databases, and users programmatically within n8n workflows. It supports a wide range of operations such as creating, retrieving, updating, archiving, searching pages; managing blocks including creation, retrieval, update, deletion, and appending children; querying and creating databases; and fetching user information.

This node is beneficial for automating content management in Notion, synchronizing data between Notion and other systems, or building complex workflows that manipulate Notion workspace elements dynamically.

Practical examples:

• Automatically create a new Notion page with custom properties and an icon when a form is submitted.
• Append formatted blocks (like paragraphs, headings, images) to an existing Notion page based on external data.
• Query a Notion database to retrieve filtered records and use them in reports or notifications.
• Archive pages automatically after a certain condition is met.
• Retrieve user details from Notion for audit or assignment purposes.

Properties

Note: The above property is part of the input properties for the Default Resource and Operation. Other properties related to page creation or update (like Parent Page/Database, Title, Properties) are defined but not requested here.

Output

The node outputs JSON data representing the response from the Notion API for the executed operation. The structure varies depending on the resource and operation:

• For pages, it returns detailed page objects including properties, parent info, and metadata.
• For blocks, it returns block objects with type, content, rich text, properties, and children if applicable.
• For databases, it returns database schema or query results with lists of entries.
• For users, it returns user profile information or lists of users.

If multiple items are processed, the output is an array of these objects wrapped in execution data.

The node does not output binary data.

Dependencies

• Requires valid Notion API credentials configured in n8n (an API key or token).
• Uses internal utility functions for:
  • Credential validation
  • ID resolution (e.g., resolving page IDs)
  • Rich text parsing and block conversion
  • Making paginated requests to Notion API endpoints

No additional external dependencies beyond the Notion API and n8n credential setup.

Troubleshooting

• Invalid Notion API credentials: The node throws an error if credentials are invalid or missing. Ensure the API key/token is correctly set up in n8n credentials.
• Unknown resource or operation errors: If an unsupported resource or operation is selected, the node will throw an error indicating the unknown value. Verify the selected options.
• JSON parsing errors: When providing JSON strings for properties, filters, or block definitions, malformed JSON will cause errors. Validate JSON syntax before input.
• No blocks provided: For block creation or appending operations, if no blocks are supplied or the format is incorrect, an error is thrown.
• Page or block ID resolution failures: If the provided IDs or URLs cannot be resolved to valid Notion IDs, operations will fail. Confirm correct IDs or URLs are used.

Links and References

• Notion API Documentation
• n8n Documentation
• Notion Rich Text Formatting

This summary focuses on the Default Resource and Operation with the provided input properties. The node supports many more properties and operations as seen in the full source code.