Notion Connector
Connect to Notion to index pages, databases, and workspace content.
Overview
The Notion connector allows you to:
- Index pages and databases
- Traverse nested page structures
- Sync database properties
- Support multiple workspaces
Prerequisites
- Notion account
- Workspace access
- OAuth authorization
Authentication
OAuth 2.0
- Click Connect with Notion
- Select workspace
- Choose pages to share
- Authorize access
Internal Integration Token
As an alternative to OAuth, you can use a Notion Internal Integration Token:
- Go to Notion Integrations
- Create a new integration
- Copy the Internal Integration Token (
integration_token) - Share the desired pages/databases with the integration
- Enter the token in ZenSearch
Page Selection
During OAuth, select which pages ZenSearch can access:
- Select individual pages
- Select entire databases
- Access flows down to child pages
Configuration
| Setting | Description |
|---|---|
| Workspace | Connected workspace |
| Root Pages | Starting pages for sync |
| root_page_ids | string[] — Specific root page IDs to sync |
| database_ids | string[] — Specific database IDs to sync |
| Include Databases | Sync database entries |
| include_databases | boolean — Whether to include databases in sync |
| include_subpages | boolean — Whether to traverse and include subpages |
| max_depth | integer — Maximum recursion depth for page traversal |
| include_images | boolean — Enable OCR processing for images |
| Traverse Depth | How deep to follow links |
Setup Steps
- Add Connector: Knowledge → Add Data Source → Notion
- Authorize: Connect with Notion OAuth
- Select Pages: Choose root pages/databases
- Configure Depth: Set traversal options
- Test & Create: Verify and save
Content Indexed
| Content | Included |
|---|---|
| Pages | Yes |
| Databases | Yes |
| Database items | Yes |
| Nested pages | Yes |
| Block content | Yes |
| Comments | Optional |
Database Handling
Notion databases are indexed as:
- Database structure (schema)
- Individual entries as documents
- Properties as metadata
Nested Page Traversal
ZenSearch follows page links:
Root Page
├── Child Page 1
│ └── Grandchild Page
├── Child Page 2
└── Linked Database
Best Practices
- Share root workspace pages for broad access
- Use specific pages for focused indexing
- Include databases for structured data
- Set appropriate traversal depth
Troubleshooting
No pages found: Ensure pages were shared during OAuth
Missing content: Check page sharing settings in Notion
Incomplete databases: Verify database was selected during auth