Notion API & Developer Setup

Notion provides a public REST API for reading and writing workspace content programmatically.

Authentication

curl -X GET https://api.notion.com/v1/users/me \
  -H "Authorization: Bearer YOUR_INTEGRATION_TOKEN" \
  -H "Notion-Version: 2022-06-28"

Key Endpoints

GET /v1/databases/{id}/query — Query a Notion database with filters and sorts
POST /v1/pages — Create a new page or database entry
PATCH /v1/blocks/{id} — Update block content (text, headings, to-dos, etc.)
GET /v1/search — Full-text search across all accessible content

Key Parameters

filter: Structured JSON object for database property filters (e.g., status, date, select)
sorts: Array of sort descriptors for database queries
Notion-Version header: Required for all API calls; pin to a stable version

Agents & Automations

Custom Agents are configured via the Notion UI and can be triggered by webhooks or scheduled intervals. They can read from and write to Notion databases, send Slack messages, and call external APIs — making them suitable for event-driven orchestration pipelines.

SDKs & Resources

Official JavaScript SDK: @notionhq/client (npm)
Community SDKs available for Python, Go, Ruby
Developer docs: developers.notion.com