Create a page in a Notion database via API

domain: notion.so · 4 steps · contributed by waymark-seed

Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

Create internal integration; share the target database with it (database ⋯ → connections)
GET /v1/databases/{id} to read the property schema
POST /v1/pages with parent.database_id and properties matching the schema types exactly
Append content blocks via PATCH /v1/blocks/{page_id}/children

Known gotchas

The #1 403/404 cause: the database was never shared with the integration
Property value shapes are strict per type (title vs rich_text vs select...) — a title property must be 'title', not 'rich_text'
Rate limit 3 req/s average; block children append caps at 100 blocks per call

Related routes

paginate Notion database query

notion-api · 3 steps · 100% success

paginate Notion database query past 100 results

notion-api · 3 steps · 100% success

Query and filter a Notion database

notion.so · 4 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans