{"registry_version":"2026.1025.387","generated_at":"2026-10-25T06:27:00Z","content_sha256":"089d16f627d9365e3d0663cc8069203706d7cb23a76c332226e29686968811a5","signed":true,"signature":{"key_id":"ed25519:74ca19268e364242","algorithm":"ed25519","expires_at":"2026-11-24T06:27:09Z","expired":false,"manifest":"/registry/manifest.json"},"id":"notion/integration","name":"Notion API connection (integration)","vendor":"Notion","status":"researched","last_verified":null,"last_researched":"2026-10-25","summary":"Create an internal connection (static token for one workspace), a personal access token, or a public OAuth connection in the Notion Developer portal; Marketplace listing needs a Notion security review.","account_model":{"summary":"Connections belong to a Notion workspace (development workspace for public connections).","accounts":[{"name":"Notion workspace","kind":"organisation","required":true,"note":"Older docs say only Workspace Owners create connections; the May 2026 release says any member can [to verify per workspace settings]."}]},"prerequisites":[],"identity_requires":[],"have_ready":[],"steps":[{"id":"create_internal","title":"Create an internal connection (single workspace)","summary":"In the Developer portal choose Build > Internal connections > Create a new connection, name it and pick the workspace, set capabilities.","route":"copilot","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":[],"optional":false,"url":"https://app.notion.com/developers","lead_time":null,"preflight":[],"captures":null},{"id":"copy_token","title":"Copy the internal API token","summary":"Open the Configuration tab and copy the API token; keep it in an environment variable.","route":"copilot","gate":"none","human_only":false,"gate_label":null,"depends_on":["create_internal"],"optional":false,"url":"https://app.notion.com/developers","lead_time":null,"preflight":[],"captures":"NOTION_API_TOKEN"},{"id":"share_pages","title":"Share pages with the connection","summary":"In each page's ••• menu choose Connections / Add connections and pick yours (or use the Content access tab); unshared pages return errors.","route":"guided","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["create_internal"],"optional":false,"url":null,"lead_time":null,"preflight":[],"captures":null},{"id":"create_public","title":"Create a public OAuth connection (other workspaces)","summary":"Build > Public connections > Create new connection; enter name, development workspace, redirect URIs, capabilities, and installation scope (Any workspace is required for Marketplace and cannot be changed later).","route":"copilot","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":[],"optional":true,"url":"https://app.notion.com/developers","lead_time":null,"preflight":[],"captures":"NOTION_OAUTH_CLIENT_SECRET"},{"id":"marketplace_review","title":"List on the Notion Marketplace (optional)","summary":"Fill in listing details in the Listings section and submit; public connections must pass a Notion security review before listing.","route":"guided","gate":"third_party_review","human_only":true,"gate_label":"The provider reviews it","depends_on":["create_public"],"optional":true,"url":"https://app.notion.com/developers","lead_time":null,"preflight":[],"captures":null}],"gates":[{"step":"create_internal","gate":"human_submit","label":"You press submit"},{"step":"share_pages","gate":"human_submit","label":"You press submit"},{"step":"create_public","gate":"human_submit","label":"You press submit"},{"step":"marketplace_review","gate":"third_party_review","label":"The provider reviews it"}],"lead_times":[],"outputs":[{"name":"NOTION_API_TOKEN","description":"Internal connection API token (or a personal access token)","secret":true,"example_format":"opaque token string","environments":null},{"name":"NOTION_OAUTH_CLIENT_ID","description":"Public connection OAuth client ID","secret":false,"example_format":"opaque id string","environments":null},{"name":"NOTION_OAUTH_CLIENT_SECRET","description":"Public connection OAuth client secret","secret":true,"example_format":"opaque secret string","environments":null}],"renewals":[],"estimated_minutes":null,"guide_url":"https://verapli.com/guides/notion/integration"}