{
  "schemaVersion": "1.0",
  "provider": {
    "id": "notion",
    "name": "Notion API",
    "provider": "Notion",
    "category": "communications",
    "status": "active",
    "summary": "A workspace content API for pages, blocks, data sources, comments, users, search, and webhooks.",
    "homepage": "https://www.notion.com/product/integrations",
    "officialDocs": "https://developers.notion.com/reference/intro",
    "baseUrl": "https://api.notion.com/v1",
    "auth": "Bearer token from an internal, personal, or OAuth connection",
    "versioning": "Required Notion-Version request header",
    "resourceGroups": [
      "Pages",
      "Blocks",
      "Databases",
      "Data sources",
      "Comments",
      "Users",
      "Search"
    ],
    "pagination": "start_cursor and page_size with next_cursor and has_more",
    "errors": "Structured JSON errors; 429 and 529 include retry guidance",
    "webhooks": "Webhook events for pages, databases, data sources, comments and more",
    "sdks": [
      "JavaScript"
    ],
    "pricing": "API access accompanies Notion connections; workspace plan limits also apply",
    "rateLimit": "Per-connection and per-workspace limits; current plan-specific values are official-doc mutable facts",
    "formats": [
      "JSON"
    ],
    "protocols": [
      "REST",
      "Webhooks"
    ],
    "bestFor": [
      "Knowledge-base integrations",
      "Content workflow automation"
    ],
    "cautions": [
      "Notion-Version is required.",
      "Respect Retry-After for 429 and 529 responses."
    ],
    "tags": [
      "pages",
      "blocks",
      "databases",
      "communications"
    ],
    "verifiedAt": "2026-09-13",
    "sourceUrls": [
      "https://developers.notion.com/reference/intro",
      "https://developers.notion.com/reference/authentication",
      "https://developers.notion.com/reference/request-limits"
    ],
    "mutableFacts": [
      {
        "key": "base-url",
        "label": "Base URL",
        "value": "https://api.notion.com/v1",
        "sourceUrl": "https://developers.notion.com/reference/intro",
        "verifiedAt": "2026-09-13"
      },
      {
        "key": "authentication",
        "label": "Authentication",
        "value": "Bearer token from an internal, personal, or OAuth connection",
        "sourceUrl": "https://developers.notion.com/reference/authentication",
        "verifiedAt": "2026-09-13"
      },
      {
        "key": "pricing",
        "label": "Pricing",
        "value": "API access accompanies Notion connections; workspace plan limits also apply",
        "sourceUrl": "https://developers.notion.com/reference/authentication",
        "verifiedAt": "2026-09-13"
      },
      {
        "key": "rate-limits",
        "label": "Rate limits",
        "value": "Per-connection and per-workspace limits; current plan-specific values are official-doc mutable facts",
        "sourceUrl": "https://developers.notion.com/reference/authentication",
        "verifiedAt": "2026-09-13"
      }
    ],
    "humanUrl": "/api-atlas/apis/notion/",
    "jsonUrl": "/api-atlas/api/providers/notion.json"
  }
}