Skip to content
AskVault Docs
Try Free →

How to connect Notion to AskVault

Written by , Principal Architect, Networks and Tech, AskVault · Reviewed by Allison Chan
Last updated: · 4 min read

What gets indexed

Notion's content model has three relevant primitives. All three are supported.

  • Pages. Standard Notion pages with rich text, headings, lists, code blocks, tables, and embedded media. The bot retrieves chunks from the page body and uses the page title as the source citation.
  • Databases. Notion databases (tables, boards, calendars, galleries). Each row in the database becomes a separately-indexable page. Database properties (Status, Owner, Tags, etc.) become metadata you can filter on.
  • Sub-pages. Nested pages under a parent. Any page shared with the AskVault integration is eligible for import, regardless of where it sits in your page tree.

What doesn't get indexed: embedded files (PDFs, images) other than as alt text, comments, version history, and synced blocks that point to inaccessible content.

Setup

Three minutes end-to-end.

  1. Open Knowledge > Add Source > Notion in AskVault. Click Connect with Notion.
  2. OAuth consent screen. Notion asks you to pick which workspace and pages to grant access to. Pick the ones with the content you want indexed.
  3. Set the import scope. Back in AskVault, leave the page-URL field blank to import every page you've shared with the integration, or paste a specific Notion page URL to import just that page. Adjust the max-pages slider (1–200 per import) if needed.
  4. Click Import. Indexing starts. 50 pages takes about 90 seconds; a full 200-page import takes several minutes.

Test the integration by asking the bot a question whose answer is in Notion. You should get a response with a source citation linking back to the Notion page.

Sync behavior

Notion content isn't synced automatically today — there's no scheduled or webhook-triggered re-sync yet. To pick up new or edited pages:

  • Re-run the import. Reopen Knowledge > Add Source > Notion and click Import again. This re-searches every page currently shared with the integration and re-indexes it; it isn't incremental, so a large re-import can take a few minutes.
  • Import a single page. Paste that page's URL to refresh just one page instead of the whole workspace.

Deleting a page in Notion doesn't remove it from AskVault automatically — delete the corresponding document from Knowledge Hub to stop the bot from retrieving it.

Permissions and access control

The OAuth scope is read-only. AskVault can read pages and databases you've granted access to, nothing more. We can't create pages, modify content, share, or change permissions.

If you remove AskVault's access in Notion's integration settings, indexing stops immediately and the integration shows as disconnected in AskVault. Already-indexed content stays in the vector store until you explicitly delete it from Knowledge Hub.

Audience tagging

For HR documents, finance policies, or other content you want restricted, audience-tag the Notion pages after they're indexed. Open Knowledge Hub > [page] > Audience and add tags like hr_team or managers. Combined with identity verification, the bot only retrieves from documents matching the caller's audience set.

This is the right pattern for an internal helpdesk bot with multiple departments. Growth+

Limits

  • Plan availability. Notion requires the Growth plan or above.
  • Pages per import. Up to 200 pages per import (adjustable via the slider in the import dialog). Paste a specific page URL to import a single page.
  • Plan-level content cap. 40 MB on Growth, 100 MB on Business, custom on Enterprise. Notion content typically averages 2 to 8 KB per page after extraction.
  • Notion API rate limits. 3 requests per second per integration. AskVault stays well within this during import.
  • Per-workspace integration count. One Notion workspace per AskVault workspace. To index multiple Notion workspaces, create separate AskVault workspaces.

Common pitfalls

Pages not showing up in Knowledge Hub. They weren't shared with the AskVault integration. In Notion, open the page, click Share, add the AskVault integration to the access list.

Bot answers from outdated content. The import hasn't been re-run since the Notion page changed — there's no automatic sync. Reopen Knowledge > Add Source > Notion and click Import again.

Sub-pages skipped during indexing. Parent page was shared but the sub-pages have their own restricted access. Share each sub-page explicitly, or grant workspace-level access to the integration.

Database rows missing. The database was shared but the rows reference pages outside the shared scope. Re-share with broader access.

FAQ

Can the bot search Notion databases by property?

Yes. The bot retrieves matching rows based on the question content. For more structured queries (e.g., "show me all rows where Status = Done"), use the custom_webhook skill to call your own backend that queries Notion's API directly.

Does this work with Notion Business accounts?

Yes. Personal, Team, Business, and Enterprise Notion plans all work.

Can I limit the integration to specific Notion pages?

Yes. During the OAuth flow, pick "Select pages" instead of "Allow access to the whole workspace". You can grant access to a specific set of pages and add more later.

What happens if I delete a page in Notion?

AskVault doesn't detect the deletion automatically — there's no scheduled sync. Delete the corresponding document from Knowledge Hub to stop the bot from retrieving it. Already-cached conversations referencing the page keep the citation link, which will 404 if the visitor clicks it.

How does sync handle large pages?

Pages over about 50,000 characters get chunked into multiple pieces. Each chunk indexes independently. Retrieval pulls the most relevant chunk; the source citation links back to the full Notion page.

Was this page helpful?