# Create Notion page

Canonical URL: https://docs.fuse.init.inc/integrations/notion/actions/pages.create

Create a Notion page under a page or data source with strict rich text.

Action ID: `pages.create`
Provider: Notion (`notion`)
Contract version: 1

## Risk and exposure

- Risk: Write
- Idempotency: Unsafe — Retries may duplicate side effects; callers must coordinate carefully.
- Availability: Default
- Exposure: REST, SDK, MCP
- MCP hints: readOnly=false, destructive=false, idempotent=false, openWorld=true

## Required scopes

- `insert_content`

## Input schema fields

- `parent`
- `parent.page_id`
- `parent.data_source_id`
- `properties`
- `properties[]`
- `properties[].name`
- `properties[].type`
- `properties[].title`
- `properties[].title[]`
- `properties[].title[].type`
- `properties[].title[].text`
- `properties[].title[].text.content`
- `properties[].title[].text.link`
- `properties[].title[].text.link.url`
- `properties[].title[].annotations`
- `properties[].title[].annotations.bold`
- `properties[].title[].annotations.italic`
- `properties[].title[].annotations.strikethrough`
- `properties[].title[].annotations.underline`
- `properties[].title[].annotations.code`
- `properties[].rich_text`
- `properties[].rich_text[]`
- `properties[].rich_text[].type`
- `properties[].rich_text[].text`
- `properties[].rich_text[].text.content`
- `properties[].rich_text[].text.link`
- `properties[].rich_text[].text.link.url`
- `properties[].rich_text[].annotations`
- `properties[].rich_text[].annotations.bold`
- `properties[].rich_text[].annotations.italic`
- `properties[].rich_text[].annotations.strikethrough`
- `properties[].rich_text[].annotations.underline`
- `properties[].rich_text[].annotations.code`
- `properties[].number`
- `properties[].select`
- `properties[].select.name`
- `properties[].multi_select`
- `properties[].multi_select[]`
- `properties[].multi_select[].name`
- `properties[].status`
- `properties[].status.name`
- `properties[].date`
- `properties[].date.start`
- `properties[].date.end`
- `properties[].checkbox`
- `properties[].url`
- `properties[].email`
- `properties[].phone_number`
- `children`
- `children[]`
- `children[].type`
- `children[].rich_text`
- `children[].rich_text[]`
- `children[].rich_text[].type`
- `children[].rich_text[].text`
- `children[].rich_text[].text.content`
- `children[].rich_text[].text.link`
- `children[].rich_text[].text.link.url`
- `children[].rich_text[].annotations`
- `children[].rich_text[].annotations.bold`
- `children[].rich_text[].annotations.italic`
- `children[].rich_text[].annotations.strikethrough`
- `children[].rich_text[].annotations.underline`
- `children[].rich_text[].annotations.code`
- `children[].checked`

## Output schema fields

- `id`
- `object`
- `url`
- `in_trash`
- `created_at`
- `updated_at`
- `title`
- `parent`
- `parent.type`
- `parent.page_id`
- `parent.database_id`
- `parent.data_source_id`
- `parent.workspace`
- `properties`
- `properties[]`
- `properties[].name`
- `properties[].type`
- `properties[].id`
- `properties[].has_more`
- `properties[].value`

Provider overview: https://docs.fuse.init.inc/integrations/notion
Actions index: https://docs.fuse.init.inc/integrations/notion/actions
Exact canonical JSON contract: https://docs.fuse.init.inc/api/catalog/v1/providers/notion/actions/pages.create
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/notion/actions