Notion

Create pages, query databases, and manage content in Notion.

When to Use

• "Add this to Notion"
• "Create a Notion page about..."
• "Query my Notion database"
• "Update the [project] page in Notion"

Auth

All requests require:

Authorization: Bearer $NOTION_API_KEY
Notion-Version: 2022-06-28
Content-Type: application/json

Key Endpoints

Base URL: https://api.notion.com/v1

Search

curl -s -X POST "https://api.notion.com/v1/search" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2022-06-28" \
  -H "Content-Type: application/json" \
  -d '{"query": "meeting notes", "page_size": 5}'

Create a Page

curl -s -X POST "https://api.notion.com/v1/pages" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2022-06-28" \
  -H "Content-Type: application/json" \
  -d '{
    "parent": {"database_id": "DATABASE_ID"},
    "properties": {
      "Name": {"title": [{"text": {"content": "Page Title"}}]}
    },
    "children": [
      {
        "object": "block",
        "type": "paragraph",
        "paragraph": {
          "rich_text": [{"type": "text", "text": {"content": "Content here"}}]
        }
      }
    ]
  }'

Query a Database

curl -s -X POST "https://api.notion.com/v1/databases/DATABASE_ID/query" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2022-06-28" \
  -H "Content-Type: application/json" \
  -d '{"page_size": 10}'

Get a Page

curl -s "https://api.notion.com/v1/pages/PAGE_ID" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2022-06-28"

Add Blocks to a Page

curl -s -X PATCH "https://api.notion.com/v1/blocks/BLOCK_ID/children" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2022-06-28" \
  -H "Content-Type: application/json" \
  -d '{
    "children": [
      {
        "object": "block",
        "type": "to_do",
        "to_do": {
          "rich_text": [{"type": "text", "text": {"content": "Task item"}}],
          "checked": false
        }
      }
    ]
  }'

Block Types

• paragraph, heading_1, heading_2, heading_3
• to_do (checkbox), bulleted_list_item, numbered_list_item
• code (add "language": "python"), toggle

Notes

• API key = Notion internal integration token
• Integration must be connected to pages/databases in Notion UI
• Rate limit: 3 requests/second
• Max 100 blocks per request