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. Add a Notion Source

   1. Navigate to Knowledge > Sources
   2. Click Add Source
   3. Select Notion
2. Authorize the Integration

   1. Click Connect to Notion
   2. You will be redirected to Notion’s authorization page
   3. Select the pages and databases you want to share with AGO
   4. Click Allow Access

   You can always change which pages are shared later from Notion’s integration settings.

3. Select Content to Sync

   After authorization, AGO displays the pages and databases available for sync.

   1. Browse the page tree and select the content you want to import
   2. You can select entire sections or individual pages
   3. Click Save

   Start with a focused subset of content. Syncing too much irrelevant content can dilute your agent’s answers.

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

---

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