Skip to main content
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

1

Open the Notion integration in Layer

In Layer, go to Integrations, find Notion, and click Connect.
2

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.
3

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.
4

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.

​
What gets synced

ObjectFieldsRefresh cadence
Workspaceworkspace id, workspace name, bot idEvery 6 hours
Membersname, email, Notion user id, avatarEvery 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

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.
Go to Integrations → Notion → Disconnect in Layer, then remove the Axiom integration from Settings & members → Connections in Notion.