Action: Create a Page

Notion Operation

Create a new page in Notion

Example User Story

As a Notion user, I want to create a new page in my workspace so that I can organize my notes and tasks effectively.

Fields

Field Name	Field Type	Required
parent_id	String	Yes
properties	Map	Yes
children	Array	No

Related Connections

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "create-page",
  "state": "inDev",
  "meta": {
    "short": "Create Page",
    "description": "Creates a new page in Notion."
  },
  "input": [
    {
      "name": "parent_id",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The ID of the parent page or database."
      }
    },
    {
      "name": "properties",
      "type": "Map",
      "required": true,
      "meta": {
        "description": "A map of property names to property values."
      }
    },
    {
      "name": "children",
      "type": "Array",
      "required": false,
      "meta": {
        "description": "An array of block objects that represent the content of the page."
      }
    }
  ],
  "output": [
    {
      "name": "id",
      "type": "String",
      "selector": ["id"],
      "meta": {
        "description": "The ID of the created page."
      }
    },
    {
      "name": "url",
      "type": "String",
      "selector": ["url"],
      "meta": {
        "description": "The URL of the created page."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "/v1/pages",
        "headers": {
          "Content-Type": "application/json",
          "Notion-Version": "2022-06-28"
        },
        "bodyTemplate": {
          "value": "{\"parent\": {\"type\": \"page_id\", \"page_id\": \"{{parent_id}}\"}, \"properties\": {{properties}}, \"children\": {{children}}}",
          "placeholders": [
            {
              "name": "parent_id",
              "type": "String",
              "description": "The ID of the parent page or database.",
              "required": true
            },
            {
              "name": "properties",
              "type": "Map",
              "description": "A map of property names to property values.",
              "required": true
            },
            {
              "name": "children",
              "type": "Array",
              "description": "An array of block objects that represent the content of the page.",
              "required": false
            }
          ]
        }
      }
    }
  ]
}