Set up the sync
Open Data Sources
Go to AI Training → Data Sources.
Start the Notion connection
Click Add source → Notion. There are no credential fields — Notion uses OAuth.
Authorize in Notion
Click Connect. A Notion authorization page opens. This is where you choose what OpenCX can read:
- Allow access to all pages — broadest. The connector can see every page in the workspace it’s installed in.
- Select pages — narrow. Pick specific pages or databases. OpenCX only sees those.
Wait for the first sync
The first pull indexes every accessible page and block. Size depends on how much you shared — small workspaces finish in minutes, larger ones take longer.
Verify in AI Instructions
Open AI Training → AI Instructions. Pages appear under Notion, linked back to their page URLs.
What gets synced
Pages
Pages
Every Notion page the OAuth scope grants access to — both top-level pages and sub-pages.
Blocks
Blocks
Block-level content within pages, synced incrementally on
last_edited_time. Together with pages, this gives the AI detailed context.Databases as pages
Databases as pages
Database rows in Notion are treated as pages at sync time. The AI sees each row’s content but doesn’t query the database structurally.
Changing scope later
To expand or narrow what the connector sees:- Remove the connection from Data Sources in OpenCX.
- In Notion, visit Settings → Connections and revoke the OpenCX integration (or leave it and skip this step if you’ll re-authorize).
- Re-add the source in OpenCX and re-authorize — this time picking a different set of pages.
Limits
| Value | |
|---|---|
| Streams synced | pages, blocks |
| Sync mode | incremental_deduped_history on last_edited_time |
| Sync cadence | Airbyte polling — typically every few hours |
| Credential type | OAuth 2.0 (no API token) |
| Multi-workspace | One Notion workspace per connection |
| Selective scoping | Set at OAuth authorization time — change by revoke + re-connect |
Related Documentation
Notion overview
What this source does.
Troubleshooting
Missing pages, re-authorization.
Website crawler
For publicly-shared Notion pages.
Connect a knowledge source
All sources.