Sign in

v3

latestOpenAPI 3.1.02026-07-31495191.1 MB
Pages

Create a page

post/v1/pages

Headers

Notion-Version'2026-03-11' required

The API version to use for this request. The latest version is 2026-03-11.

Request body

propertiesobject
markdownstring

Page content as Notion-flavored Markdown. Mutually exclusive with content/children.

allow_asyncboolean

Set to true to receive an async_task response for markdown page creation. Only supported when markdown is provided.

Example request

{
  "icon": {
    "icon": {
      "name": "pizza"
    }
  },
  "content": [
    {
      "embed": {
        "caption": [
          {
            "text": {
              "link": {
                "url": "https://www.notion.com"
              }
            }
          }
        ]
      }
    }
  ],
  "children": [
    {
      "embed": {
        "caption": [
          {
            "text": {
              "link": {
                "url": "https://www.notion.com"
              }
            }
          }
        ]
      }
    }
  ],
  "template": {
    "timezone": "America/New_York"
  }
}

Response

OR

Example response

{
  "icon": {
    "icon": {
      "name": "pizza"
    }
  }
}