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

# Notion

> Connect a Notion workspace to Layer with one-click OAuth — inventory the workspace and its members with no API tokens to paste.

The Notion integration discovers your Notion workspace and its members so they show up in Layer's identity graph alongside the rest of your SaaS. New connections use a one-click OAuth flow — there's no integration token to create or paste.

## What you'll need

* Notion workspace **Owner** role.
* Two minutes.

## Set it up

<Steps>
  <Step title="Open the Notion integration in Layer">
    In Layer, go to **Integrations**, find Notion, and click **Connect**.
  </Step>

  <Step title="Pick the workspace to connect">
    You'll be redirected to Notion's OAuth screen. If you have access to multiple Notion workspaces, pick the one you want Axiom to inventory.
  </Step>

  <Step title="Select pages to share with Axiom">
    Notion asks which pages the integration should see. Selecting **All pages** gives the broadest visibility; selecting individual pages narrows the scope. Member discovery works either way.
  </Step>

  <Step title="Wait for the first sync">
    You'll land back at **Integrations** with the Notion card marked connected. The initial sync runs immediately and typically finishes in a couple of minutes.
  </Step>
</Steps>

## What gets synced

| Object    | Fields                               | Refresh cadence |
| --------- | ------------------------------------ | --------------- |
| Workspace | workspace id, workspace name, bot id | Every 6 hours   |
| Members   | name, email, Notion user id, avatar  | Every 6 hours   |

The workspace appears as a SaaS app in your Layer inventory. Each human member with an email becomes a user node, joined to other identity sources by email. Bot users and members without an email are skipped.

## Permissions Layer never asks for

Layer does not request scopes for reading or modifying page content. The connector only calls Notion's `/users` endpoint and the workspace metadata returned during OAuth — page bodies and database rows are never fetched.

## Token refresh

Notion access tokens do not expire. If the Axiom integration is removed from your Notion workspace, the connection status changes to **needs re-auth** and you can reconnect with one click from **Integrations → Notion → Reconnect**.

## Member enumeration requires the right scope

Listing workspace members uses Notion's `read_user_with_email` capability. If the OAuth grant doesn't include user-read access — for example, on workspaces where the integration was approved with a narrower scope — the workspace itself still syncs as a SaaS app, but no member nodes are created. Reconnect from **Integrations → Notion** and approve the user-read prompt to populate members.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Workspace synced but no members appeared">
    The OAuth grant didn't include the user-read capability, or every workspace member is a bot. Reconnect from **Integrations → Notion** and confirm the workspace approver granted access to read users.
  </Accordion>

  <Accordion title="Notion consent screen shows the wrong workspace">
    Notion signs you in as your most-recently-used workspace by default. On the consent screen, switch accounts or pick a different workspace from the picker before approving.
  </Accordion>

  <Accordion title="I want to disconnect">
    Go to **Integrations → Notion → Disconnect** in Layer, then remove the Axiom integration from **Settings & members → Connections** in Notion.
  </Accordion>
</AccordionGroup>