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

# Notion

> Connect Aperium to Notion pages, databases, and comments through per-user OAuth, with admin-only approval-gated writes.

The Notion integration lets each user link their own Notion account so agents can search the workspace, read pages and databases as markdown, query data sources, and, with approval, create and update Notion content. A tenant admin registers the Notion integration once; each user then authorizes with their own Notion account and chooses which pages and databases the integration may access in Notion's consent picker. The tool surface mirrors Notion's official MCP server.

<Note>
  Aperium calls Notion as the connecting user and only ever sees the pages and databases that user grants during Notion's consent step.
</Note>

## What you'll need

* A **Notion public integration** (OAuth) registered in your Notion workspace, and its **client ID** and **client secret**.
* Access to the Aperium **admin onboarding flow** or the **Admin Console's MCP Servers tab**.

## Admin setup

<Steps>
  <Step title="Register a Notion public integration">
    In Notion's integration settings, create a **public** (OAuth) integration. Aperium's setup form displays the exact redirect (callback) URL to register — copy it from the form into Notion's integration configuration.
  </Step>

  <Step title="Paste the credentials into Aperium">
    Open the **Connect Aperium to Notion** form and enter the **client ID** and **client secret**. Once saved, the Notion tile appears on every user's Integrations page.
  </Step>

  <Step title="Users link their accounts">
    Each user clicks **connect** on the Notion tile, is redirected to Notion's consent screen, selects which pages and databases to share, and approves.
  </Step>
</Steps>

## What agents can do

**Read** — search the workspace; fetch a page (rendered as markdown), database, or data source; discover data sources and query their rows and views; and search comments, workspace users, and meeting notes.

**Write (approval-gated, admin-only)** — create and update pages, move and duplicate pages, create databases, update data sources, create and update views, and add comments. Every write is restricted to **tenant admins** and pauses for human approval before it runs.

<Note>
  Notion writes are approval-gated *and* floored to the tenant-admin role. A non-admin user's agent can read Notion but cannot invoke any write tool.
</Note>

## Notes

* **Single account.** Notion does not support linking multiple accounts per user.
* **Async writes.** Some markdown page creates and updates run asynchronously; the result returns a task handle to poll. A duplicated page returns immediately as a shell and fills its copied content in the background — re-fetch the page before relying on the body.
* **Scope limits.** Only unresolved comment threads are returned, and Notion teamspaces are not exposed by the public API.