Skip to main content

Connect Notion

Pull pages from your Notion workspace into an agent's knowledge base, and keep them in sync.

How the Connection Works​

Notion connects at the workspace level: one connection serves the whole Leezy organization. Which pages a given chatbot imports is then chosen per chatbot.

:::warning Read This Before You Click Through On Notion's consent screen you choose which pages to share with Leezy. Two consequences are easy to miss:

  • The selected pages become available to all chatbots in this workspace.
  • If the same Notion account is already connected to another Leezy workspace, the selection here also affects that workspace.
  • Unchecking a previously selected page revokes access immediately, with no recovery step. :::

Connecting​

  1. Go to your agent's Sources page and open the Notion tab
  2. Click Connect to Notion
  3. Read the notice, then continue to Notion
  4. Select the pages to share
  5. Confirm

Only organization owners and admins can connect Notion. See Roles.

Choosing Pages​

After connecting, pick the shared pages this chatbot should learn from. Each selected page is fetched, chunked, and embedded like any other source.

Sub-pages follow their parent's sharing in Notion — if a parent is shared, its children are reachable.

Adding More Pages Later​

Re-running the Notion authorization shows every page currently shared with Leezy, with previously selected pages already checked.

:::danger Leave Existing Checkboxes Alone Unchecking a page removes it from every chatbot in the workspace that depends on it. To add pages, check additional items and confirm — do not uncheck what is already there. :::

Keeping Content in Sync​

Imported pages are re-synced so edits in Notion reach the knowledge base. Deleting the source in Leezy removes that knowledge immediately.

Reconnecting​

If the connection is revoked in Notion or the token expires, the Sources page shows a Reconnect Notion prompt. Reconnect to resume syncing; imported content stays in place meanwhile but stops updating.

What Works Well​

  • Internal wikis and runbooks
  • Product and policy pages maintained by non-technical teams
  • Meeting notes that document decisions customers ask about

What to Avoid​

  • Pages containing personal data of employees or customers
  • Scratch and draft pages — an agent cannot tell a draft from a decision
  • Databases used as trackers rather than documentation

Storage​

Notion pages count toward your organization's storage quota like any other source — 500 KB on the free tier, 50 MB on paid plans.

Next Steps​

Last updated on