Skip to main content

Notion

Lets an agent read, search, and update Notion pages and databases in a workspace you control.

What it can do​

  • Search pages and databases by title or content
  • Fetch a page with its full block tree
  • Create and update pages, comments, and database rows
  • Move pages between parents
  • Read workspace users and teams

How to get credentials​

Notion uses a workspace integration token.

  1. Go to notion.so/profile/integrations and click New integration.
  2. Give it a name (e.g. "FlyMyAI Agent"), pick the workspace, and set the type to Internal.
  3. Under Capabilities, enable at least Read content, Update content, Insert content, plus any user-info scope you need.
  4. Click Save. On the next screen copy the Internal Integration Secret — it starts with secret_ or ntn_.
  5. Open any page or database you want the agent to touch, click … → Connections → Add connections, and select your new integration. Notion only exposes pages that are explicitly shared with the integration.

Fields to fill in FlyMyAI​

FlyMyAI fieldWhere it comes from
Notion API tokenThe Internal Integration Secret from step 4.

Troubleshooting​

  • unauthorized or object_not_found — the page isn't shared with the integration. Share it from the page's Connections menu.
  • restricted_resource — the integration is missing the capability the agent tried to use. Re-open the integration settings and enable the missing scope.
  • Token rotated — paste the new secret in FlyMyAI; the old one stops working immediately.