Create a page

curl --location --request POST 'https://api.notion.com/v1/pages' \ --header 'Notion-Version;' \ --header 'Content-Type: application/json' \ --data-raw '{ "parent": "string", "properties": "string", "children": "string", "icon": "string", "cover": "string" }'

{ "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" }

Request

Header Params

Notion-Version

string

required

Body Params application/json

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.

Examples

Request

Responses