# Page Create

Notion

Create a page in a connected Notion workspace with properties and optional content.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Page Create (tool ID: notion.page-create). Ask me for the details you need, then show me the result. Help me connect the required app account if needed.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

This tool also needs you to connect your app account.

Connect your first agent to receive $1 trial credit.

**Job:** [Read and write Notion pages](https://scrollport.com/tools/notion-mcp)

**Current price:** $0.0025/request

**Availability:** Requires connected account

## Tool details

**About this tool**

Creates a Notion page under a parent page or data source, optionally with initial blocks. Always one upstream request at $0.0025.

**Inputs and outputs**

### Input

`body` object · required

Bounded request body sent to the connected application.

### Output

`id` string

Returned id value.

`is_archived` boolean

Returned is archived value.

`object` string

Returned object value.

`properties` object

Returned properties value.

`url` string

Returned url value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "notion.page-create",
  "input": {
    "body": {
      "parent": {
        "type": "data_source_id",
        "data_source_id": "YOUR-NOTION-DATA-SOURCE-ID"
      },
      "properties": {
        "Name": {
          "title": [
            {
              "text": {
                "content": "Competitive research brief"
              },
              "type": "text"
            }
          ]
        },
        "Status": {
          "rich_text": [
            {
              "text": {
                "content": "Draft"
              },
              "type": "text"
            }
          ]
        }
      }
    }
  }
}
```

### Output

```
{
  "id": "1b2c3d4e-0000-4000-8000-000000000007",
  "url": "https://app.notion.com/p/1b2c3d4e000040008000000000000007",
  "object": "page",
  "properties": {
    "Name": {
      "type": "title",
      "title": [
        {
          "type": "text",
          "plain_text": "Competitive research brief"
        }
      ]
    },
    "Status": {
      "type": "rich_text",
      "rich_text": [
        {
          "type": "text",
          "plain_text": "Draft"
        }
      ]
    }
  },
  "is_archived": false
}
```

**Errors and limitations**

- `connection_required`: This capability acts on your own Notion workspace, which isn't connected yet.Open connect_url, approve access, then retry this run unchanged.

---

Canonical page: https://scrollport.com/tools/providers/notion/page-create