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 [email protected] 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.
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 source.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 and select workspace

Select a method to log in to Notion.Notion login screen
4

Grant access to pages and databases

In the Notion dialog, grant permission for Qontext to view the pages you select.Notion page and database pickerThen, select the pages, databases, or top-level teamspace you want Qontext to index. Use the search bar to find specific pages. Confirm to complete the OAuth flow.Notion page selection
5

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
6

Set ingestion instructions (optional)

You can add free-form instructions that tell Qontext how to interpret or prioritize the synced data. This step is optional.Ingestion instructions field
7

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 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 [email protected].
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 and databases are shared with the Qontext integration. If the issue persists, contact [email protected].