Connect Notion as a Knowledge Source

Step-by-step guide to sync your Notion workspace with AGO

Connect a Notion workspace to AGO so your agents can answer questions from your Notion content.

Prerequisites

• Admin access to your Notion workspace
• Admin or staff access to AGO

---

1. Connect your Notion workspace

   1. Navigate to Knowledge > Sources > Connections
   2. Click Connect with Notion
   3. In the Notion window, select the pages and databases you want to share with AGO
   4. Click Allow Access

   The workspace now appears under Connections. You only do this once — every source you create can read through the same connection.

   You can change which pages are shared at any time from Notion’s integration settings.

   If there is no Connect with Notion button, this AGO instance has no Notion integration set up. Use an API token instead — see Notion Integration.

2. Create a source on that workspace

   1. Go to Knowledge > Sources > Create
   2. Name the source and select Notion
   3. Pick your workspace under Notion workspace
   4. Click Choose a page, browse the tree, and select the page or database to import
   5. Click Save

   AGO detects on its own whether you picked a page or a database, and imports subpages with it.

   Create one source per area you want to keep separate — a handbook, a product database — all on the same connection. Sources are what you assign to agents, so splitting them lets you give each agent only what it needs.

3. Wait for the Initial Sync

   The first sync may take a few minutes depending on the volume of content.

   • Track progress on the Sources page — the status indicator shows sync state
   • Once complete, check the document count to verify the right content was imported
4. Verify Content Quality

   1. Navigate to Knowledge > Quality
   2. Filter by your Notion source
   3. Review quality scores for imported documents
   4. Fix any flagged issues at the source in Notion, then re-sync

   Common Notion-specific issues:

   • Nested toggles — deeply nested content may not import with full structure
   • Database views — only the default view is imported
   • Embedded content — external embeds (videos, iframes) are not imported
5. Assign to an Agent

   1. Navigate to AI Studio > Agents
   2. Edit your agent
   3. Under Knowledge Sources, select the Notion source
   4. Click Save

   Your agent can now answer questions from your Notion content.

Ongoing Sync

AGO automatically syncs Notion content based on your configured schedule. When you update a page in Notion, the changes will appear in AGO after the next sync.

To trigger a manual sync:

1. Go to Knowledge > Sources
2. Click on your Notion source
3. Click Sync Now

---

Troubleshooting

Issue	Cause	Fix
Pages missing after sync	Pages not shared with the integration	Go to Notion > Settings > Integrations and share the missing pages
A page is missing from the picker	Only what you shared with the integration is listed	Share it in Notion, then reopen the picker
A page appears at the top level instead of under its parent	Its parent was not shared with the integration	Share the parent page too
Content outdated	Sync has not run since the change	Trigger a manual sync
Empty documents	Page contains only unsupported content types	Add text content to the page
Authorization fails	Notion admin restrictions	Ask your Notion workspace admin to approve the integration

---

Removing a connection

Go to Knowledge > Sources > Connections and click Disconnect. AGO lists the sources that read through it first — they stop syncing until the workspace is connected again.

Related

• Notion Integration — full configuration reference
• Knowledge Source Management — managing all sources
• Knowledge Quality — quality analysis details
• Set Up Your Knowledge Base — complete knowledge setup tutorial