Actions6
Overview
The "Update Page Properties" operation of the Notion AI Tool node allows users to modify metadata and properties of an existing Notion page. This includes updating fields such as status, priority, tags, or any custom property defined on the page. The node accepts either a JSON object or a natural language description to specify which properties to update.
This operation is beneficial in scenarios where you want to automate the management of Notion pages, for example:
- Automatically marking tasks as "In Progress" or "Done" based on external triggers.
- Updating project statuses or priorities without manual intervention.
- Synchronizing data from other systems into Notion page properties.
Practical example: You have a task management system integrated with n8n, and when a task is completed, you use this node to update the corresponding Notion page's "status" property to "Done" and set the "priority" to "Low".
Properties
| Name | Meaning |
|---|---|
| Target Page ID | The ID or URL of the existing Notion page whose properties you want to update. |
| Properties to Update | The properties to update on the page, specified either as a JSON string (e.g., {"status": "Done"}) or as a natural language instruction (e.g., "Set status to Done and priority to Low"). |
| Additional Options | Optional settings including: • Icon: Emoji icon for the page (e.g., 📝, 🎯, 📊). • Cover Image URL: URL of a cover image for the page. • Max Results: Maximum number of results to return (1-100), though not typically relevant for this operation. |
Output
The node outputs a JSON array where each item corresponds to one input item processed. For the "Update Page Properties" operation, each output item contains:
operation: The operation performed ("updatePageProperties").success: Boolean indicating if the update was successful.pageId: The resolved ID of the updated page.updatedProperties: An array of property names that were updated.message: A human-readable message summarizing the update (e.g., "Updated 2 properties").result: The full response object returned by the Notion API after the update, containing details about the updated page.
No binary data is produced by this operation.
Dependencies
- Requires valid Notion API credentials configured in n8n to authenticate requests.
- Relies on the Notion API to perform page updates.
- No additional external services are required beyond the Notion API.
Troubleshooting
- Invalid Notion API credentials: The node will throw an error if the provided API credentials are invalid or missing. Ensure your Notion integration token is correctly set up in n8n.
- Invalid Target Page ID: If the page ID or URL is incorrect or inaccessible, the node will fail to resolve the page and throw an error. Verify the page identifier is correct and accessible by the integration.
- Malformed Properties to Update: If the JSON string is malformed or the natural language parser cannot interpret the instructions, the node may fail or update properties incorrectly. Use valid JSON or clear natural language instructions.
- API Rate Limits: Frequent updates may hit Notion API rate limits causing errors. Implement retry logic or reduce request frequency if needed.
- Unsupported Property Types: Some complex property types might not be supported or require specific formatting. Consult Notion API documentation for property formats.