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 update can be specified either in JSON format or using natural language instructions.
This operation is beneficial when you want to programmatically keep your Notion pages up-to-date with changing information without manually editing them. For example, you could automate project management workflows by setting a task's status to "In Progress" or "Done" based on external triggers, or update priority levels dynamically.
Practical examples:
- Automatically mark a meeting notes page as "Reviewed" after a calendar event ends.
- Change the status of a project page to "Completed" once all tasks are done.
- Update tags or categories on a knowledge base article based on content analysis.
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 change on the page, provided either as a JSON string (e.g., {"status":"Done"}) or as natural language (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 for the page cover image • Return Full Content: Boolean to decide if full page content should be returned instead of just metadata • Max Results: Maximum number of results to return (1-100), though not typically relevant for this operation |
Output
The output JSON object contains:
pageId: The resolved ID of the updated page.updatedProperties: An array listing the keys of the properties that were updated.message: A human-readable message summarizing the update (e.g., "Updated 2 properties").result: The raw response from the Notion API representing the updated page data.
If the "Return Full Content" option is enabled, the node may include the entire page content; otherwise, it returns only metadata about the page.
No binary data output is produced by this operation.
Dependencies
- Requires a valid Notion API authentication token configured in n8n credentials.
- Uses the Notion REST API endpoints to patch page properties.
- No additional external services are required beyond Notion API access.
Troubleshooting
- Invalid Credentials Error: If the node throws an error about invalid Notion API credentials, verify that the API key/token is correctly set up and has sufficient permissions to edit pages.
- Malformed Properties Input: Providing improperly formatted JSON or unclear natural language in "Properties to Update" can cause parsing errors or unexpected updates. Use valid JSON or clear, simple phrases like "Set status to Done".
- Page Not Found: If the target page ID or URL is incorrect or inaccessible, the node will fail. Double-check the page identifier.
- No Properties Updated: If the parsed properties object is empty, no changes will be made. Ensure the input specifies at least one property to update.
- API Rate Limits: Frequent updates might hit Notion API rate limits; consider adding delays or error handling for retries.