Notion

Search pages and databases, read and update content blocks.

Install

amodal connect notion

Authentication

Bearer token authentication with required version header.

• NOTION_API_KEY — Internal integration token from https://www.notion.so/my-integrations

Every request includes the Notion-Version: 2022-06-28 header automatically. The integration must be explicitly shared with pages/databases it needs to access.

Endpoints

Search

• POST /v1/search — Search pages and databases

Pages

• GET /v1/pages/:page_id — Retrieve a page
• POST /v1/pages — Create a page (confirmation)
• PATCH /v1/pages/:page_id — Update page properties (confirmation)
• DELETE /v1/pages/:page_id — Archive a page (confirmation)

Databases

• GET /v1/databases/:database_id — Retrieve a database
• POST /v1/databases/:database_id/query — Query a database
• POST /v1/databases — Create a database (confirmation)
• PATCH /v1/databases/:database_id — Update database properties (confirmation)

Blocks

• GET /v1/blocks/:block_id/children — Retrieve block children
• PATCH /v1/blocks/:block_id/children — Append block children (confirmation)
• DELETE /v1/blocks/:block_id — Delete a block (confirmation)

Users

• GET /v1/users — List all users

Entities

• search, page, database, query, block

Rules

• Rate limit: 3 requests per second per integration — use pagination instead of parallel requests
• Integrations can only access pages/databases explicitly shared with them; empty search results may indicate missing access, not missing content
• Block children are not included in page retrieval — must fetch separately via /v1/blocks/:block_id/children
• Rich text content is an array of segments — concatenate .plain_text for display; formulas and rollups are computed server-side and cannot be set directly