Skip to main content

Notion

kapa provides an integration that enables pulling content from your Notion knowledge base.

Step 1: Enabling Access​

In order to give kapa access to your Notion space, you need to first create a new "kapa" integration within your notion space Notion, along with an integration token. Finally you will need to "connect" the pages that you wish to ingest to the integration.

Obtaining a Notion Token

In order to obtain a Notion Token, you will need to create a new "internal" integration in your Notion space in the integration's settings page. You can call it "Kapa Integration," for example. You are required to be a workspace owner to create an integration.

You can read more about setting up internal integrations in the Notion docs.

Sharing pages with the Integration

For the integration to be able to access your pages, you will need to actively "connect" or "share" the pages with the integration. To share a page with an integration, visit the page in your Notion workspace, click the ••• menu at the top right of the page, scroll down to the Connections section, click Connect to, and use the search bar to find and select the integration from the dropdown list.

Note that sharing a page or database with an integration will also give access to all its children.

You can read more about this here.

Input the token

You can now go ahead and add the token to the Notion configuration form in the kapa dashboard:

Notion Token Configuration

Step 2: Configure Pages​

Once you have provided an integration token in the kapa Notion source configuration form, you will be able to configure which pages or databases you would like to include. By default, all pages in a given Notion workspace that have been shared with the integration in the previous step will be pulled.

You can further restrict the pages that should be pulled with the following parameters:

  • Last updated after: Only fetch pages that were last updated after the selected date.
  • Databases Include: Only include the selected Notion Databases, along with all the pages they contain.
  • Databases Exclude: Exclude the selected Notion Databases, along with all the pages they contain.
  • Pages Include: Only include the selected pages.
  • Pages Exclude: Exclude the selected pages.
  • Pages Include With Children: Only include the selected pages, along with their sub-pages.
  • Pages Exclude With Children: Exclude the selected pages, along with their sub-pages.
Notion Pages Configuration

Tips & Tricks​

  • Apply smart filtering: Avoid ingesting pages that primarily contain images and interactive elements – focus on adding high-quality text content that can help answer questions
  • Focus on recency: remove old legacy content after a certain cut-off date that is likely to be no longer relevant