Notion API - Public Beta (English)
  1. Pages
Notion API - Public Beta (English)
  • Introduction
  • Integration capabilities
  • Request limits
  • Status codes
  • ENDPOINTS
    • Authentication
      • Authentication
      • Token
    • Blocks
      • Delete a block
      • Append block children
      • Retrieve a block
      • Update a block
      • Retrieve block children
    • Databases
      • Filter database entries
      • Sort database entries
      • Update database properties
      • Retrieve a database
      • Update a database
      • Query a database
    • Pages
      • Archive a page
      • Retrieve a page property item
        GET
      • Create a page
        POST
      • Retrieve a Page
        GET
      • Update Page properties
        PATCH
    • Users
      • List all users
      • Retrieve your token's bot user
      • Retrieve a user
    • Comments
      • Create comment
      • Retrieve comments
    • Search
      • Search optimizations and limitations
      • Search by title
  • OBJECTS
    • Block
    • Comment
    • Unfurl attribute object for Link Previews
    • Page
      • Page
      • Page properties
    • Database
      • Database
      • Database properties
    • User
      • User
      • Comment
    • Other
      • Emoji object
      • File object
      • Parent object
      • Rich text object
  • Versioning
    • Versioning
    • Changes by version
  • ENDPOINTS Copy
    • Authentication
      • Authentication
      • Token
    • Blocks
      • Retrieve a block
      • Update a block
      • Retrieve block children
      • Delete a block
      • Append block children
    • Databases
      • Filter database entries
      • Sort database entries
      • Update database properties
      • Retrieve a database
      • Update a database
      • Query a database
      • Create a database
    • Pages
      • Archive a page
      • Retrieve a Page
      • Update Page properties
      • Retrieve a page property item
      • Create a page
    • Users
      • Retrieve a user
      • List all users
      • Retrieve your token's bot user
    • Comments
      • Create comment
      • Retrieve comments
  1. Pages

Create a page

POST
https://api.notion.com/v1/pages
Request Request Example
Shell
JavaScript
Java
Swift
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"
}'
Response Response Example
200 - Results
{
    "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

Body Params application/json

Examples

Responses

🟢200OK
application/json
Body

🟠404Results
Modified at 2023-04-28 08:49:29
Previous
Retrieve a page property item
Next
Retrieve a Page
Built with