Skip to main content

​
Overview

The Notion connection allows Qontext to read pages and database pages from a connected Notion workspace and ingest their text content into your Context Vault.
Only pages and content that the connected Notion user can access will be ingested into your vault.
Supported data types:
ObjectDescription
PagesPublic and shared pages with text, headings, and inline content
Database PagesNotion databases (rows, properties, and their page content)
Unsupported:
ObjectDescription
AttachmentsContent behind URLs and attachments (e.g. audio, images, video, embeds)
Use a dedicated integration user in your Notion workspace to ensure a stable and uninterrupted connection.
Create a service account such as qontext@yourcompany.com and grant it access to the pages or teamspaces you want Qontext to ingest. This prevents sync disruptions when employee accounts or permissions change.
The integration user will:
  • Authenticate the connection between Qontext and Notion.
  • Access shared pages and teamspaces with the minimum required permissions.

​
Setting up the connection

You can connect Notion from your Qontext vault, authorize access in Notion, then choose what to sync and how often. The steps below walk you through the full flow.
You can also manage all your credentials, including Notion, from the Credentials page. Credentials created there can be reused across any vault.
1

Open Data Sources in your vault

In the Qontext app, open the vault where you want Notion data, then go to the Data Sources tab and click + Add.Data Sources tab in a Qontext vault
2

Select Notion as the data source

Choose Notion from the list of available data sources. This starts the Notion connection flow.Select Notion from the list of integrations
3

Connect Notion

You can reuse existing Notion credentials (if you’ve already connected this Notion account to Qontext) or create a new connection.Notion page selection
4

Grant access to pages and databases

In the Notion dialog, grant permission for Qontext to view the pages you select.Notion allow accessThen, select the teamspace from which you want to provide information to Qontext. Confirm to complete the OAuth flow.
It is recommended to select the whole teamspace and filter it in the next step via the Qontext UI. This makes it easier to manage and adapt your Notion connection.
Notion page selection
5

Configure what to sync (filters)

Select the pages and database pages you want Qontext to ingest into your vault. Use the search bar to find them or navigate through subpages by clicking on Page.Configure what to sync (Notion filters)Click the + next to a page to add it and the x next to a selected page at the top to remove it from the selection.
6

Set sync frequency

Choose how often Qontext should refresh data from Notion (e.g. daily, weekly, monthly). More frequent syncs keep the vault up to date but use more resources.Sync frequency settings
7

Set ingestion instructions (optional)

You can add ingestion instructions that tell Qontext how to interpret or prioritize the synced data. This step is optional.Ingestion instructions field
8

Review and create connection

Review your choices (workspace, pages, frequency), then confirm to create the connection. Qontext will start the initial sync shortly after.

​
Managing permissions

  • Use a single integration user to manage Notion access for Qontext to avoid permission conflicts.
  • Prefer a share-by-default approach for large sections and exclude pages you do not want indexed.
  • Avoid multiple users creating separate Qontext connections for the same Notion pages. This can cause duplication or access conflicts.

​
Share additional pages with Qontext

To share a specific page or database page from Notion:
  1. Open the page in Notion.
  2. Open the … menu and add the Qontext integration.
  3. Ensure parent pages are shared where relevant to maintain hierarchy. Notion page share dialog for Qontext

​
Sync latency

The initial sync time depends on workspace size and structure. Large or deeply nested workspaces can take up to 12 hours to fully index.

​
FAQ

Every Notion Member can set up the Notion connection. Make sure that the account has the required access to the pages you want to ingest.
Yes, you can connect multiple Notion accounts to one Qontext workspace. Ideally, connect each Notion workspace only once to avoid duplication or access conflicts.
Disconnecting stops further syncs. Content already ingested from Notion remains in your vault until you request deletion. For data removal, contact support@qontext.ai.
By default, Qontext only ingests pages the connected Notion account has full access to. Additionally, you can add filters to every connection as described in the setup flow.
Initial sync time varies: small workspaces may finish in under an hour; very large or complex workspaces can take up to 12 hours. Subsequent syncs are incremental and faster.
Reconnect the integration and verify that the relevant pages are shared with the Qontext integration. If the issue persists, contact support@qontext.ai.