Docs/Knowledge Base/Notion Sync

Notion Sync

If your team uses Notion for internal documentation, SOPs, wikis, or knowledge bases, you can import those pages directly into your agent without copying any content manually. The Notion integration uses OAuth so your credentials are never stored — you authorise access through Notion's own login flow.

How it works

When you import a Notion page, the system fetches the page's block content via the Notion API and converts it to plain text. That text is then processed through the same chunking and embedding pipeline as uploaded files — it is split into chunks, embedded into vectors, and stored in the knowledge base. The agent retrieves Notion content the same way it retrieves any other source: by semantic similarity to the visitor's question.

What content is extracted

The following Notion block types are extracted as text:

  • Paragraphs
  • Headings (H1, H2, H3)
  • Bulleted and numbered list items
  • Quote blocks
  • Callout blocks
  • Code blocks (the text content, not syntax-highlighted output)

Embedded images, databases (tables), linked databases, and toggle blocks are not extracted in the current version. If your Notion pages are primarily visual or rely heavily on inline databases, consider exporting the content as a PDF and uploading it as a file instead.

Setting up the Notion integration

1

Open Knowledge Base → Notion

In your agent's left menu, click Knowledge Base and select the Notion tab.
2

Click Connect Notion

You are redirected to Notion's authorization page. Log in with your Notion account and click Allow Access.
3

Grant page access in Notion

In the authorization step, Notion asks which pages to share with AIChatVault. Select the specific pages or parent pages you want the agent to access. Only pages you explicitly share here will be visible — the integration cannot see any other pages in your workspace.
4

Browse and select pages to import

After connecting, a page browser shows up to 100 pages from your workspace. Check the pages you want to import into this agent's knowledge base.
5

Click Import

The selected pages are fetched, extracted, chunked, embedded, and indexed. A confirmation message shows how many pages were successfully imported.

Keeping content up to date

Notion content is imported as a snapshot — it reflects the state of the page at the time of import. If you update a page in Notion, the agent will not automatically pick up the change. To refresh content, return to the Notion tab and import the page again. The existing version is replaced with the latest content.

💡
If your Notion pages change frequently (e.g. a pricing page or product roadmap), set a reminder to re-import those specific pages after each update so the agent stays accurate.

Privacy and access

  • Only pages you explicitly shared during the OAuth authorization step are accessible to the integration.
  • Pages you did not share — including all private pages, pages in other workspaces, and pages shared only with specific team members — are never accessible.
  • To grant access to additional pages after the initial setup, you can reconnect Notion and select the additional pages during the re-authorization step.
  • To revoke access entirely, click Disconnect in the Notion tab. This removes the stored authorization token. Existing imported content remains in the knowledge base until you delete it.

Disconnecting Notion

To disconnect the Notion integration, click Disconnect in the Notion tab. This removes the stored authorization token and prevents any further imports. It does not automatically delete pages that were already imported — those remain as knowledge sources until you manually delete them from the knowledge base.

ℹ️
The Notion integration uses Notion's official OAuth API. AIChatVault does not store your Notion login credentials — only the access token issued by Notion after you authorize the connection.

Was this page helpful?