Notion
Notion workspace.
Access mode: Read-only
Required information
| Field | Details |
|---|---|
| Workspace | Notion workspace name/ID. |
| Integration token | Internal integration created at notion.so/my-integrations. Must be shared with target pages/databases. |
| Page/Database IDs | Specific pages or databases, or “all shared content” (integration only sees content explicitly shared with it). |
Network considerations
Fully managed SaaS. HTTPS to api.notion.com. No VPN needed.
No IP allowlisting is available. Access is controlled purely by integration token scope.
Credential and auth management
Internal integration token: Created in workspace settings. Token is scoped to the workspace.
Content must be explicitly shared with the integration. This is a manual step per page/database (or at parent page level to cascade).
No token expiry, but can be revoked anytime by workspace admin.
Rate limit: 3 requests/second. Flume implements backoff.
Validation checks
| Check | Method | Expected result |
|---|---|---|
| Authentication | GET https://api.notion.com/v1/users/me | Returns bot user info |
| Search | POST https://api.notion.com/v1/search | Returns shared pages/databases |
| Page read | GET https://api.notion.com/v1/pages/<id> | Returns page metadata |
| Block content | GET https://api.notion.com/v1/blocks/<id>/children | Returns page content blocks |
Every connection starts from the pre-engagement checklist and goes through the universal validation protocol before production sign-off.