Common scenarios
| Symptom | Likely cause | Fix |
|---|---|---|
| Expected pages aren’t in AI Instructions | During OAuth, you picked Select pages and didn’t include them | Remove the connection in OpenCX, re-authorize with broader scope, then re-sync. Or, in Notion’s own Settings → Connections, edit which pages OpenCX can access — the next sync picks up the change. |
| I shared access to a page but its sub-pages are missing | Notion’s permission model doesn’t cascade shared access to every sub-page automatically; each needs explicit sharing or the parent must grant recursive access | In Notion, open the parent page → Connections → ensure the OpenCX integration is added. Sub-pages inherit if the parent grants. |
| Private pages are appearing | Notion’s OAuth is based on what you shared at authorization. If “Allow all” was picked, all private pages under that workspace are in scope. | Revoke the OpenCX integration in Notion’s Settings → Connections, re-authorize from OpenCX with a narrower selection. |
| Page edits take hours to show up | Incremental sync on last_edited_time — Airbyte’s schedule determines the lag | Trigger an immediate sync from the source row in Data Sources. For structural edits (new pages, reorganizations), a full run is triggered next cycle. |
| Database rows are synced but I can’t query them as a table | By design — the connector syncs rows as pages for retrieval, not as a queryable table | Re-model the database as pages, or use AI Actions on the Notion API if you need query behavior. |
| None of the above | — | Contact support with the connection ID and a sample Notion page URL. |
Related Documentation
Connect Notion
Re-authorize with different scope.
Notion overview
What this source does.
Quick Training
Add content the connector can’t see.
Connect a knowledge source
All sources.