Actions6
Overview
This node operation "Create Database Entry" allows users to create a new entry in a Notion database by specifying the parent database and the properties of the new entry. It is useful for automating data input into Notion databases, such as adding tasks, projects, contacts, or any structured information managed within Notion.
Typical scenarios include:
- Automatically logging form submissions or survey results into a Notion database.
- Creating new project entries with predefined properties from external systems.
- Adding records to a CRM or inventory database without manual entry.
For example, you can use this node to add a new task to your Notion task database by providing the database ID and the task details as JSON or natural language description.
Properties
| Name | Meaning |
|---|---|
| Parent Page/Database ID | The ID or URL of the parent 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 | Collection of optional settings: • Icon: Emoji icon for the page (e.g., 📝, 🎯, 📊) • Cover Image URL: URL for the page cover image • Return Full Content: Boolean to return full content or just metadata (not used directly here) • Max Results: Maximum number of results to return (1-100) (not used directly here) |
Output
The output JSON object includes:
entryId: The unique identifier of the newly created database entry.databaseId: The ID of the database where the entry was created.message: A confirmation message indicating successful creation.result: The full response object returned by the Notion API representing the created entry.
No binary data is output by this operation.
Dependencies
- Requires a valid Notion API key credential configured in n8n to authenticate requests.
- Uses the Notion API endpoints to create pages within a database.
- No additional external dependencies beyond the Notion API.
Troubleshooting
- Invalid credentials error: If the node throws an error about invalid Notion API credentials, verify that the API key is correctly set up and has sufficient permissions to create database entries.
- Malformed entry properties: If the
Entry Propertiesfield contains invalid JSON or unrecognized natural language, the node may fail to parse it properly. Ensure the JSON syntax is correct or use simple property descriptions. - Invalid Parent ID: Providing an incorrect or inaccessible database ID or URL will cause the creation to fail. Confirm the database exists and the ID is accurate.
- API rate limits: Frequent calls might hit Notion API rate limits; consider adding delays or handling retries if errors occur.