Notion AI Tool

AI-powered tool for creating and managing Notion content. Designed for use with AI Agent Nodes.

Actions6

Overview

This node integrates with the Notion API to create a new entry in a specified Notion database. It allows users to specify the parent database by its ID or URL and define the properties of the new database entry either as JSON or natural language description. This operation is useful for automating data entry into Notion databases, such as adding new tasks, projects, contacts, or any structured data you manage within Notion.

Practical examples:

  • Automatically add new customer records to a CRM database in Notion.
  • Create task entries in a project management database when triggered by external events.
  • Log form submissions or survey responses as new rows in a Notion database.

Properties

Name Meaning
Parent Page/Database ID The ID or URL of the parent page or database where the new entry will be created.
Entry Properties Properties for the new database entry, provided either as JSON or a natural language description.
Additional Options Optional settings including:
• Icon — Emoji icon for the page (e.g., 📝, 🎯, 📊)
• Cover Image URL — URL of cover image for the page
• Max Results — Maximum number of results to return (1-100), though not directly relevant for creation

Output

The node outputs a JSON array containing objects with details about the created database entry:

  • entryId: The unique identifier of the newly created database entry.
  • databaseId: The resolved ID of the parent database where the entry was created.
  • message: A confirmation message indicating successful creation.
  • result: The full response object returned from the Notion API representing the created page/entry.

No binary data output is produced by this operation.

Dependencies

  • Requires valid Notion API credentials (an API key or token) configured in n8n.
  • Relies on the Notion API endpoint /pages to create new database entries.
  • The node uses internal utility functions to resolve page/database IDs and parse property inputs.

Troubleshooting

  • Invalid Notion API credentials: The node throws an error if the credentials are invalid or missing. Ensure that the API key/token is correctly set up in n8n.
  • Malformed Entry Properties: If the Entry Properties input is not valid JSON or cannot be parsed properly, the creation will fail. Use correct JSON syntax or clear natural language descriptions.
  • Incorrect Parent ID: Providing an invalid or inaccessible parent page/database ID or URL will cause the request to fail. Verify the ID or URL corresponds to a valid Notion database.
  • API Rate Limits: Frequent requests may hit Notion API rate limits, resulting in errors. Implement retry logic or reduce request frequency if needed.

Links and References

Discussion