Create a page

POSThttps://api.notion.com/v1/pages

Request

Header Params

Notion-Version

string

required

parent

string

required

The parent page or database where the new page is inserted, represented as a JSON object with a page_id or database_id key, and the corresponding ID.

properties

string

required

The values of the page’s properties. If the parent is a database, then the schema must match the parent database’s properties. If the parent is a page, then the only valid object key is title.

children

string

required

The content to be rendered on the new page, represented as an array of block objects.

icon

string

required

The icon of the new page. Either an emoji object or an external file object..

cover

string

required

The cover image of the new page, represented as a file object.

{
  "parent": "string",
  "properties": "string",
  "children": "string",
  "icon": "string",
  "cover": "string"
}

Request samples

Responses

OK(200)

Results(404)

HTTP Code: 200

Content Type : JSONapplication/json

object {0}

{
  "object": "page",
  "id": "59833787-2cf9-4fdf-8782-e53db20768a5",
  "created_time": "2022-03-01T19:05:00.000Z",
  "last_edited_time": "2022-07-06T19:16:00.000Z",
  "created_by": {
    "object": "user",
    "id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
  },
  "last_edited_by": {
    "object": "user",
    "id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
  },
  "cover": {
    "type": "external",
    "external": {
      "url": "https://upload.wikimedia.org/wikipedia/commons/6/62/Tuscankale.jpg"
    }
  },
  "icon": {
    "type": "emoji",
    "emoji": "🥬"
  },
  "parent": {
    "type": "database_id",
    "database_id": "d9824bdc-8445-4327-be8b-5b47500af6ce"
  },
  "archived": false,
  "properties": {
    "Store availability": {
      "id": "%3AUPp"
    },
    "Food group": {
      "id": "A%40Hk"
    },
    "Price": {
      "id": "BJXS"
    },
    "Responsible Person": {
      "id": "Iowm"
    },
    "Last ordered": {
      "id": "Jsfb"
    },
    "Cost of next trip": {
      "id": "WOd%3B"
    },
    "Recipes": {
      "id": "YfIu"
    },
    "Description": {
      "id": "_Tc_"
    },
    "In stock": {
      "id": "%60%5Bq%3F"
    },
    "Number of meals": {
      "id": "zag~"
    },
    "Photo": {
      "id": "%7DF_L"
    },
    "Name": {
      "id": "title"
    }
  },
  "url": "https://www.notion.so/Tuscan-Kale-598337872cf94fdf8782e53db20768a5"
}

Last modified: 2 years ago