Connect Notion to Fondoo

Live2 min readUpdated

Create an internal integration at notion.so/profile/integrations, copy the Internal Integration Secret, and share each page or database with it via the page menu > Connections. Archiving pages needs owner approval for agents. Webhooks are not implemented.

Credentials

apiKey: Internal integration secret, starting with secret_ or ntn_ (prefix UNCERTAIN), followed by 10–200 letters, digits or underscores.

Permissions

Read content, Update content and Insert content. The integration sees only pages and databases shared with it through Connections. test() calls GET /users/me and confirms no capability.

Capabilities

Read: search, databases.get, databases.query, pages.get, blocks.children.list. Write: pages.create, pages.update, blocks.children.append. Destructive: pages.archive; agents need owner approval.

Webhooks

Not implemented.

Limits and uncertainties

Notion averages 3 requests/s per integration; Fondoo's local budget is 90 requests per 60 seconds. Requests send Notion-Version 2022-06-28. UNCERTAIN: the 2025-09-03 version moves databases to data sources and databases.query, so it is not adopted. The secret_ and ntn_ prefixes are UNCERTAIN. API reference.