Docs / Work tools
Notion
Connect a Notion internal integration and share only the pages and databases the agent needs.
Pangea connects to Notion with an internal integration that you create in your Notion workspace. The agent then reads and writes only the pages and databases you share with that integration.
Create the integration
- Open Notion integrations and click New integration.
- Pick the workspace, give it a name, and create it as an Internal integration.
- Choose the capabilities the work needs, such as read, update and insert content, and comments.
- Copy the Internal Integration Secret. It starts with
ntn_.
Connect it in Pangea
As a team Administrator, open Connectors, find Notion and click Add. Enter a Label to identify the workspace and paste the secret into Integration Token. Pangea checks the token and stores it encrypted.
This is a team connection, not each member's personal Notion account.
Share pages with the integration
A valid token does not expose every page in the workspace. Notion only shows the integration pages that were shared with it.
- Open each page or database the agent should reach.
- Click ••• → Connections and add your integration.
Sharing a parent page also shares its child pages. To check the setup, ask the agent to read one shared page you know.
Use it
The agent can search the content it can reach, read pages and databases, create and update pages, append blocks, query databases, and read or post comments, all within the integration's capabilities. Name the parent page or database, and review the content before it publishes.
Troubleshoot and disconnect
If a page is missing, check the workspace, the integration's capabilities and the page's connections before you rotate the token.
When access is no longer needed, remove the connection in Pangea. Then revoke the secret, or remove the page connections in Notion. This does not delete content the agent already wrote, or text already copied into conversations.
See Notion connection management for how Notion handles access.