Actions16
Overview
The node implements advanced integration with Notion, focusing on full-featured page management within a Notion workspace. Specifically, the Page - Create operation allows users to create new pages under a specified parent (which can be a page or database). This is useful for automating content creation workflows, such as generating project documentation, meeting notes, or task pages dynamically based on external triggers.
Practical examples include:
- Automatically creating a new project page in a Notion workspace when a new project is initiated in another system.
- Generating daily journal pages with predefined properties and metadata.
- Creating task pages linked to a database with custom properties set programmatically.
Properties
| Name | Meaning |
|---|---|
| Parent Page/Database | The ID or search term identifying the parent under which the new page will be created. |
| Title | The title of the new page. |
| Properties | A collection of key-value pairs defining the page's properties. 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 the page should be archived immediately after creation. |
Output
The output is a JSON object representing the newly created Notion page as returned by the Notion API. It includes all standard page fields such as:
id: The unique identifier of the page.parent: Information about the parent page or database.properties: The properties set on the page, reflecting the input properties.iconandcover: If provided, these fields contain the icon and cover details.- Other metadata fields managed by Notion.
No binary data output is produced by this operation.
Dependencies
- Requires valid Notion API credentials configured in n8n to authenticate requests.
- Uses the Notion REST API endpoint
/pagesto create pages. - Relies on utility functions for formatting rich text and resolving page IDs internally.
- No additional external dependencies beyond the Notion API and n8n environment.
Troubleshooting
- Invalid Credentials Error: The node throws an error if the Notion API credentials are invalid or missing. Ensure that a valid API key or token with appropriate permissions is configured.
- Invalid Property Value Format: Property values for complex types must be valid JSON strings. Malformed JSON will cause errors during parsing. Validate JSON syntax before input.
- Parent ID Resolution Failure: If the parent page or database ID cannot be resolved from the input string, the request will fail. Verify that the parent identifier is correct and accessible.
- API Rate Limits: Frequent calls may hit Notion API rate limits, resulting in errors. Implement retry logic or reduce call frequency if needed.
- Archiving Immediately: Setting the archive flag to true will archive the page right after creation, which might not be intended. Double-check this setting.