Skip to main content
The Notion feed connects an index to Notion through a public OAuth connection. After you authorize Circuit and explicitly share the pages or databases you want to include, Circuit imports them and keeps the index in sync as content changes.

​
What you can do

  • Sync individual pages: Share specific Notion pages with the Circuit connection. Only the pages you share are imported.
  • Sync databases: Share a database with the connection to import every page inside it. Pages added later flow in automatically on the next sync.
  • Pull from any workspace: Each user can connect their own workspace, and admins can connect a shared workspace for team-wide content.
  • Stay in sync automatically: Circuit re-checks the source periodically. Updates and deletions in Notion are mirrored to the index.

​
Before you start

  • A Notion account with access to the pages or databases you want to sync.
  • Permission to add connections in the target workspace. Workspace owners on Enterprise plans can restrict who is allowed to add connections to pages.
  • An index in Circuit where the Notion content should live. See Indexes if you need to create one.

​
Connect Notion

Notion uses per-page sharing. The OAuth grant alone does not give Circuit access to any content. After you connect, you must add Circuit as a connection on every page or database you want to sync. Step 5 below is the step most users miss.
1

Open the index's Integrations tab

In Circuit, open the index that should receive the Notion content, then choose Integrations > New integration.
2

Choose Import from Notion

Select Import from Notion. Circuit redirects you to Notion’s sign-in page.
3

Sign in to Notion and select a workspace

Sign in with the account that has access to the content you want to sync. If you belong to more than one workspace, Notion asks which workspace to install the connection in.
4

Approve the requested access

Notion shows the capabilities Circuit requests (see What Circuit accesses below). Click Select pages to continue, then Allow access.
5

Share each page or database with Circuit

This is the step that controls what Circuit actually reads. In Notion, open every page or database you want to sync, click the … menu at the top right, choose Connections > Add connections, and select Circuit. Sharing a parent page or database also shares its child pages.If you skip this step, Circuit will connect successfully but find nothing to import.
6

Start the import

Return to Circuit and click Done. Circuit imports the shared content. Depending on volume, the initial import takes a few minutes to a few hours. Subsequent updates run in the background.

​
What Circuit accesses

Notion uses a capabilities model rather than named scopes. Circuit requests:
CapabilityWhy Circuit needs it
Read contentRead the body and metadata of pages and databases you share with the connection.
Read user information (no email)Resolve page authors and editors to display names so search results show who wrote the content.
Circuit only reads from pages and databases you explicitly share with the Circuit connection in Notion. Anything that has not been shared is invisible to Circuit, even within the same workspace.
Circuit does not write to Notion through this integration. The connection has no create, update, or delete capability.

​
For IT and security teams

Notion does not have a central admin consent flow like Microsoft Entra ID. Instead, control happens inside each Notion workspace:
  • Per-workspace install: Connections are installed and managed within a single Notion workspace at a time. Each workspace owner decides whether to install Circuit.
  • Restricting who can add connections (Enterprise plans): Workspace owners can restrict adding and removing connections to owners only. Open Settings > Connections in Notion, then change Who can manage page access to Workspace owners. Members will then be unable to attach the Circuit connection to a page.
  • Reviewing connected pages: Workspace owners can audit which pages a connection is attached to from Settings > Connections, then selecting Circuit.
  • Revocation: Removing Circuit from Settings > Connections revokes Circuit’s access to every page in that workspace immediately.
For cross-integration credential handling, transport security, and review patterns, see Integration security and admin consent.

​
Disconnect or rotate access

  • From Circuit: open the index’s Integrations tab, select the Notion feed, and click Remove. Circuit deletes the stored refresh token and stops syncing. Already-imported documents stay in the index until you delete them.
  • From Notion (per user): open Settings > My connections, find Circuit, and click Disconnect.
  • From Notion (workspace-wide): a workspace owner can open Settings > Connections, find Circuit, and remove it. This revokes access for every user in that workspace.
  • From a single page: open the page in Notion, click … > Connections, hover the Circuit entry, and click Disconnect. The page stops syncing but other shared pages continue.

​
Troubleshooting

The OAuth grant alone does not give Circuit access to any pages. Open each page or database you want to sync in Notion, click … > Connections > Add connections, and select Circuit. Sharing a parent page also shares its children.
Circuit imports shared content on its next sync cycle, usually within a few hours. If a page has been shared for longer than that and is still missing, check whether the page is inside a database or page that has not been shared, and confirm the user who installed the Circuit connection still has access to the page.
The user who originally installed the connection has lost access to the page, or the connection has been removed from the page. Re-add the Circuit connection in the page’s … > Connections menu, or ask a workspace owner to re-install Circuit.
Your workspace may restrict connection management to workspace owners. Ask a workspace owner to add the Circuit connection to the page, or to change the Who can manage page access setting under Settings > Connections.
Deletions are picked up on the next sync cycle, usually within a few hours. Force a re-sync from the feed’s settings if a removed page persists for longer.

​
Reference

  • OAuth flow: Notion public OAuth (authorization code)
  • Access model: Capabilities-based, scoped to pages and databases explicitly shared with the connection
  • Redirect URI: https://app.circuit.ai/api/notion-oauth
  • Application name shown on consent screen: Circuit
  • Notion’s own docs: Authorization, Add and manage connections