> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nuphos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

> Connect an internal integration and share only the pages it needs.

Create an **Internal** integration for the intended Notion workspace at
[Notion integrations](https://www.notion.so/my-integrations). Choose its
capabilities for the work you need and copy the internal integration secret.

Open **Connectors → Connect → Notion** as an Administrator. Enter a label and the
integration token in the secure form. Nuphos verifies the token and stores it
encrypted. This is a team binding, not every member's personal Notion account.

## Grant content access

In each intended Notion page or database, use **••• → Connections** to add the
integration. A valid token does not expose every page in the workspace. Ask the
agent to read a known shared page to verify both authentication and content access.

## Use it

The agent can search accessible content, read pages and databases, create or
update pages and append blocks within the integration's capabilities. Name the
parent page or database and review the intended content before publishing.
Remember that sharing a parent can expose child content too.

## Troubleshoot and disconnect

For a missing page, check workspace, integration capabilities and page sharing
before rotating the token. Remove the binding in Nuphos and revoke the secret
or remove page connections in Notion when access is no longer needed. This does
not delete content already written or copied into transcripts.

See [Notion connection management](https://www.notion.com/help/add-and-manage-connections-with-the-api)
for the provider-side access model.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.