Notion Advanced

Overview

This node provides advanced integration with the Notion API, enabling comprehensive management of Notion resources such as pages, blocks, databases, and users. It supports a wide range of operations including creating, retrieving, updating, archiving, searching pages; managing blocks (create, get, update, delete, append children); querying and creating databases; and fetching user information.

Typical use cases include automating content creation and updates in Notion workspaces, managing complex page structures with nested blocks, querying databases for data retrieval or reporting, and integrating user data from Notion into workflows. For example, you can automate the creation of project documentation pages with custom icons and covers, update task lists by appending new to-do blocks, or query a database to extract filtered records for further processing.

Properties

Note: The above property is a collection allowing users to add optional metadata when creating or updating pages.

Output

The node outputs JSON data representing the response from the Notion API for the requested operation. This typically includes detailed objects corresponding to pages, blocks, databases, or users depending on the resource and operation selected.

• For page operations, the output contains page details including properties, title, icon, cover, and archived status.
• For block operations, the output includes block content, type, properties, and any child blocks if applicable.
• Database operations return database schema or query results with records.
• User operations provide user profile information or lists of users.

The node does not output binary data.

Dependencies

• Requires valid Notion API credentials configured in n8n to authenticate requests.
• Uses internal utility functions for:
  • Validating credentials.
  • Resolving page IDs from input strings or URLs.
  • Constructing request payloads for various Notion entities.
  • Handling pagination for list endpoints.
• Relies on the Notion REST API endpoints for all operations.

Troubleshooting

• Invalid Notion API credentials: The node will throw an error if the provided credentials are invalid or missing. Ensure that the API key/token is correctly set up in n8n credentials.
• Malformed JSON inputs: Properties like filters, rich text, block properties, and children expect valid JSON strings. Errors parsing these will cause operation failure. Validate JSON syntax before input.
• Missing required parameters: Operations require specific IDs or parameters (e.g., pageId, blockId, databaseId). Omitting these will result in errors.
• Unknown resource or operation: Selecting unsupported resource or operation values will throw descriptive errors.
• No blocks provided: For block creation or appending children, ensure at least one block is defined; otherwise, an error is raised.
• API rate limits or network issues: Standard Notion API limitations apply; handle retries or backoff externally if needed.

Links and References

• Notion API Documentation
• Notion Blocks Overview
• Notion Pagination Guide
• n8n Documentation

If you need details about other resources or operations, please specify.