Connect Notion
Bring your Notion pages and databases into your Inherent knowledge base and keep them in sync automatically — no manual re-uploads when content changes.
Connecting Notion is available to any account in good standing — trialing or on a paid plan. If your trial has ended, the Integrations page shows an upgrade prompt instead; reconnecting isn't required once you upgrade, everything picks back up on its own.
How It Works
- From Dashboard → Integrations, click Connect Notion. You're redirected to Notion's consent screen to authorize access.
- Back in Inherent, click Add sync on the new connection and walk through a 3-step wizard: pick a workspace, pick the pages and databases to bring in, and pick a schedule.
- The initial backfill starts immediately in the background — every selected page and database row is fetched, converted to Markdown, and ingested the same way a manually uploaded file is (parse → chunk → embed → index).
- From then on, the sync checks Notion for changes on its schedule (or whenever you click Sync now) and only re-ingests what actually changed.
Notion pages/databases → Markdown snapshot → Upload → Parse → Chunk → Embed → Index
Can't See Your Page?
Notion integrations can only see pages and databases that have been explicitly shared with them — this is a Notion platform restriction, not an Inherent one. If a page you expect to sync doesn't show up in the picker:
- Open the page in Notion.
- Click ••• → Connections (or Add connections, depending on your Notion version).
- Find and add the Inherent integration.
- Re-open the sync wizard in Inherent (or click the search box again) — newly shared pages appear without needing to reconnect.
Sharing a parent page with the integration doesn't automatically share its children. If you want an entire section of your Notion workspace synced, either share each page individually or enable Also sync sub-pages when selecting a parent page in the wizard — Inherent then walks the page tree for you (up to a bounded depth) instead of you sharing every sub-page by hand.
Sync Schedules
| Schedule | Behavior |
|---|---|
| Manual | Only syncs when you click Sync now. |
| Hourly | Checks Notion for changes once per hour. |
| Daily | Checks Notion for changes once per day. |
Sync now triggers an on-demand incremental check regardless of the sync's schedule — useful right after editing something in Notion when you don't want to wait for the next scheduled run. It only re-fetches pages whose content actually changed since the last successful run; unchanged pages are skipped at negligible cost.
What Happens When Content Changes
- Edited pages are detected on the next sync (scheduled or manual) and re-ingested — the old version is replaced, not versioned alongside it.
- Archived or deleted pages in Notion are removed from your knowledge base on the next sync.
- New pages added to an already-selected database, or new sub-pages under a page with Also sync sub-pages enabled, are picked up automatically — no need to edit the sync's selection.
A sync's page/database selection is fixed when you create it. To sync additional pages that weren't part of the original selection, create a new sync (or delete and recreate this one with an updated selection).
Connection vs. Sync
A single Notion connection (one OAuth authorization) can back multiple syncs into different workspaces — for example, syncing your "Product Wiki" pages into one workspace and a "Support" database into another, without re-authorizing Notion each time. Each sync's documents stay isolated to the workspace it was created in.
Troubleshooting
| Symptom | What it means |
|---|---|
| Sync shows an Attention badge | The connection's Notion access was revoked (e.g. the integration was removed in Notion, or the token expired). Reconnect from the Integrations page to resume. |
| A run shows partial | Some items in that run were deleted (archived in Notion) rather than created/updated — this is expected, not a failure, though genuine per-item errors are also reported this way. Check the sync's run history for details. |
| Integrations page shows a locked upgrade prompt | Your trial has ended. Upgrade from the prompt shown — your connections and syncs resume automatically once you do, nothing needs to be reconnected. |
Every sync run keeps counters (created / updated / skipped / deleted / failed) and, on failure, a short error message — open a sync's history from the Integrations page to see exactly what happened on its last few runs.