Skip to main content
The Notion connector enables Omni to index and search content from your Notion workspace, including databases, pages, and all nested content blocks.

​
Overview

​
What Gets Indexed

SourceContent
DatabasesDatabase title, description, and property schema definitions
Database EntriesPage content, properties (title, select, date, etc.), and nested blocks
Standalone PagesFull page content including all nested blocks
Block TypesParagraphs, headings, lists, code blocks, tables, toggles, bookmarks, equations, callouts, and more

​
How It Works

  1. You create a Notion internal integration and share content with it
  2. The connector syncs all shared databases and pages via the Notion API
  3. Page content is rendered from blocks — nested children are fully traversed and included
  4. Incremental sync fetches only pages modified since the last sync
The connector uses read-only access. Omni cannot modify any content in your Notion workspace.

​
Prerequisites

Before setting up the Notion connector, ensure you have:
  • Notion account with permission to create integrations
  • Omni deployment with the Notion connector service running

​
Setup

​
Step 1: Create a Notion Internal Integration

  1. Go to My Integrations
  2. Click New integration
  3. Select the workspace you want to connect
  4. Give the integration a name (e.g., “Omni Search”)
  5. Under Capabilities, ensure these are selected:
    • Read content
    • Read user information (without email addresses)
  6. Click Save
  7. Copy the Internal Integration Secret (starts with ntn_)
Keep your integration secret secure. Anyone with access to this token can read content shared with the integration.

​
Step 2: Share Content with the Integration

Notion integrations can only access pages and databases that have been explicitly shared with them. This is a critical step. To share a page or database:
  1. Open the page or database in Notion
  2. Click the … menu in the top-right corner
  3. Scroll to Connections and click Connect to
  4. Find and select your integration (e.g., “Omni Search”)
Share top-level pages to grant access to all their child pages automatically. For example, sharing a team wiki’s root page will make all nested pages accessible to the connector.

​
Step 3: Connect in Omni

  1. Navigate to Settings → Integrations in Omni
  2. Find Notion and click Connect
  3. Enter your Internal Integration Secret
  4. Click Connect
  5. Click Sync Now to start the initial sync
Your Notion connector is now configured. Initial indexing may take a while depending on the amount of content in your workspace.

​
Managing the Integration

​
Viewing Sync Status

Navigate to Settings → Integrations → Notion to view:
  • Last sync time
  • Number of indexed pages and databases
  • Any sync errors

​
Sync Modes

The Notion connector supports two sync modes:
ModeDescription
FullSyncs all shared databases and pages (used for initial sync)
IncrementalSyncs only pages modified since the last sync (used for updates)
After the initial full sync, the connector automatically performs incremental syncs to capture new and updated content.

​
Adding More Content

To index additional pages or databases:
  1. Share the new content with your integration in Notion (see Step 2)
  2. The next sync will automatically include the newly shared content

​
Removing the Integration

  1. Navigate to Settings → Integrations → Notion
  2. Toggle the Enabled switch off
This will preserve connector data and credentials, but no new data will be synced.

​
Troubleshooting

The integration secret may be expired or revoked.Solution:
  1. Go to My Integrations
  2. Select your integration and regenerate the secret
  3. Update the token in Omni via Settings → Integrations → Notion
Notion has API rate limits. The connector handles these automatically with exponential backoff.Solution: Wait for the connector to retry. For large workspaces, initial sync may take longer due to rate limits.
Database entries are only indexed if the parent database is shared with the integration.Solution: Ensure the database itself (not just individual entries) is shared with the integration via Connections.

​
Security Considerations

  • Read-only access: The connector only reads page and database content
  • Token security: Integration secrets should be treated like passwords
  • Encrypted storage: Credentials are encrypted at rest in Omni
  • Explicit sharing: Only content explicitly shared with the integration is accessible — the connector cannot access your entire workspace by default

​
What’s Next

Search Your Data

Learn how to search across Notion pages

AI Assistant

Ask questions about your Notion content

Add More Connectors

Connect additional data sources