Notion Advanced

Full-featured Notion node with exhaustive block and formatting support using existing credentials

Overview

The node implements advanced integration with Notion, focusing here on the Page Create operation. It allows users to create new pages within a specified parent (which can be a page or database) in Notion. This is useful for automating content creation workflows, such as generating project documentation, meeting notes, or task pages dynamically based on external triggers.

Typical use cases include:

  • Automatically creating a new project page in a Notion workspace when a new project is initiated.
  • Adding a new client record page inside a CRM database.
  • Generating daily journal pages under a parent page or database.

The node supports setting the page title, defining multiple properties with various data types, and adding optional icon and cover images to customize the page appearance.

Properties

Name Meaning
Parent Page/Database The ID or search term of the parent page or database where the new page will be created.
Title The title of the new page.
Properties A collection of properties to set on the page. Each property includes:
- Name: The property name.
- Type: The type of the property. Options include Title, Rich Text, Number, Select, Multi-select, Date, People, Files, Checkbox, URL, Email, Phone, Formula, Relation, Rollup, Created Time, Created By, Last Edited Time, Last Edited By.
- Value: The value for the property. For complex types, this should be JSON-formatted.
Additional Fields Optional extra fields for the page:
- Icon: An emoji or image URL to use as the page icon.
- Cover: URL of an image to use as the page cover.
- Archive: Boolean flag indicating whether to archive the page upon creation (default false).

Output

The output is the JSON response from the Notion API representing the newly created page object. This includes all page metadata such as its ID, properties, parent information, icon, cover, and other relevant details.

No binary data output is produced by this operation.

Dependencies

  • Requires valid Notion API credentials configured in n8n to authenticate requests.
  • Uses Notion's REST API endpoints for page creation.
  • Relies on utility functions for formatting rich text, resolving page IDs, and constructing the request payload.

Troubleshooting

  • Invalid Notion API credentials: The node validates credentials before execution. Ensure that the API key/token is correct and has sufficient permissions to create pages.
  • Malformed property values: Property values for complex types must be valid JSON strings. Invalid JSON will cause errors. Use proper JSON formatting for multi-selects, relations, etc.
  • Parent ID resolution failure: The parent parameter must resolve to a valid page or database ID. If a search term is used, ensure it uniquely identifies a parent.
  • API rate limits or network issues: Standard Notion API limitations apply; handle retries or backoff as needed.
  • Missing required fields: Parent and Title are mandatory. Omitting these will result in errors.

Links and References

Discussion