Create Database

notion.create_database

ActionBusiness appsconnection required

Calls the Notion API with the connection's credentials.

Create a database as a child of an existing page.

Ask about Notion All Notion nodes Provider API docs ↗

Connection

Required: Yes — the node will not save without one
Auth type: API key
Providers: Notion
Secret shape: the integration token, or {"token": "…"}
Resolved by: config.connection_id, else node.connection_id

Configuration

7 fields, 2 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

Field	Type	Required	Default	Constraints	Example
parent_page_id Id of the page the database is created under.	string	Yes	—	—	—
properties The column schema, e.g. {"Name": {"title": {}}, "Status": {"select": {"options": [{"name": "Open"}]}}}.	object	Yes	—	≥ 1 characters	{"Name":{"title":{}},"Status":{"select":{"options":[{"name":"Open"}]}}}
title Database title as plain text.	string	No	—	—	—
description Database description as plain text.	string	No	—	—	—
is_inline True renders the database inline in its parent page.	boolean	No	—	—	—
icon Notion icon object, e.g. {"type": "emoji", "emoji": "📘"}.	object	No	—	—	{"emoji":"📘","type":"emoji"}
cover Notion cover object, e.g. {"type": "external", "external": {"url": "…"}}.	object	No	—	—	—

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "icon": {
    "emoji": "📘",
    "type": "emoji"
  },
  "properties": {
    "Name": {
      "title": {}
    },
    "Status": {
      "select": {
        "options": [
          {
            "name": "Open"
          }
        ]
      }
    }
  }
}

Output

One shape.

result

Field	Type	Example
ok True when Notion created the database.	boolean	true
database_id Id of the new database.	string	—
url Notion URL of the new database.	string	—

{
  "database_id": "",
  "ok": true,
  "url": ""
}

Notes

The schema needs exactly one column of type 'title'.
The parent page must be shared with your integration.

Related Notion nodes

Templates that use Notion

See Create Database run in a workflow.

In a technical demo we add the Notion connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.

Book a technical demo Talk to sales