Action: Create a Database

Notion Operation

Create a new database in Notion

Example User Story

As a Notion user, I want to create a new database in my workspace so that I can organize and track my tasks and projects.

Fields

Field Name	Field Type	Required
parent	Object	Yes
title	Array	Yes
properties	Object	Yes
icon	Object	No
cover	Object	No

Related Connections

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "create-database",
  "state": "inDev",
  "meta": {
    "short": "Create Database",
    "description": "Creates a new database in Notion."
  },
  "input": [
    {
      "name": "parent",
      "type": "Object",
      "required": true,
      "meta": {
        "description": "The parent object (page or workspace) where the database will be created."
      }
    },
    {
      "name": "title",
      "type": "Array",
      "required": true,
      "meta": {
        "description": "The title of the database as an array of rich text objects."
      }
    },
    {
      "name": "properties",
      "type": "Object",
      "required": true,
      "meta": {
        "description": "The schema of the database properties."
      }
    },
    {
      "name": "icon",
      "type": "Object",
      "required": false,
      "meta": {
        "description": "The icon of the database."
      }
    },
    {
      "name": "cover",
      "type": "Object",
      "required": false,
      "meta": {
        "description": "The cover of the database."
      }
    }
  ],
  "output": [
    {
      "name": "id",
      "type": "String",
      "selector": ["id"],
      "meta": {
        "description": "The ID of the created database."
      }
    },
    {
      "name": "url",
      "type": "String",
      "selector": ["url"],
      "meta": {
        "description": "The URL of the created database."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "/v1/databases",
        "headers": {
          "Content-Type": "application/json",
          "Notion-Version": "2022-06-28"
        },
        "bodyTemplate": {
          "value": "{\"parent\": {{parent}}, \"title\": {{title}}, \"properties\": {{properties}}, \"icon\": {{icon}}, \"cover\": {{cover}}}",
          "placeholders": [
            {
              "name": "parent",
              "type": "Object",
              "description": "The parent object where the database will be created.",
              "required": true
            },
            {
              "name": "title",
              "type": "Array",
              "description": "The title of the database as an array of rich text objects.",
              "required": true
            },
            {
              "name": "properties",
              "type": "Object",
              "description": "The schema of the database properties.",
              "required": true
            },
            {
              "name": "icon",
              "type": "Object",
              "description": "The icon of the database.",
              "required": false
            },
            {
              "name": "cover",
              "type": "Object",
              "description": "The cover of the database.",
              "required": false
            }
          ]
        }
      }
    }
  ]
}