Notion

Kapa provides an integration that enables pulling content from your Notion knowledge base. This integration allows you to leverage your existing documentation, wikis, and collaborative content stored in Notion to power your AI assistant with accurate information.

Prerequisites

• A Notion workspace
• Workspace owner permission to create an integration
• A Notion integration token
• Pages shared with the integration

Data ingested

When you connect Kapa to Notion, the following data is ingested:

• Page URLs
• Page titles and full content
• Page hierarchy (breadcrumbs)
• Metadata including creation and modification dates
• Page properties

Setup

Step 1: Enabling access

To give Kapa access to your Notion space, you need to create a new integration and obtain an integration token:

1. Visit the Notion integrations settings page
2. Click Create new integration
3. Give it a name (e.g., "Kapa Integration")
4. Select the workspace where you want to use the integration
5. Click Submit to create the integration
6. Copy the Internal Integration Token that appears

note

You must be a workspace owner to create an integration. For more details, see the Notion documentation.

Next, share the pages you want to ingest with the integration:

1. Visit the page in your Notion workspace
2. Click the ⋯ menu at the top right of the page
3. Scroll down to the Connections section
4. Click Connect to and select your integration from the dropdown list

note

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

Step 2: Configure the Kapa platform

1. Go to the Sources tab in the Kapa platform
2. Click Add new source
3. Select Notion as the source type
4. Paste your integration token into the provided field
5. Configure which pages to include using the filtering options
6. Click Save to begin the ingestion process

Configuration options

The following configuration options are available for the Notion integration:

Option	Description	Default	Required
Integration Token	The Notion integration token	None	Yes
Last updated after	Only fetch pages updated after this date	All time	No
Databases Include	Only include selected Notion Databases and their pages	All databases	No
Databases Exclude	Exclude selected Notion Databases and their pages	None	No
Pages Include	Only include the selected pages	All pages	No
Pages Exclude	Exclude the selected pages	None	No
Pages Include With Children	Only include selected pages and their sub-pages	None	No
Pages Exclude With Children	Exclude selected pages and their sub-pages	None	No

Best practices

• 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
• Organize by importance: Start by connecting your most critical documentation first, then expand to additional content
• Structure content hierarchically: Notion's parent-child page relationship works well with Kapa's knowledge structure
• Use meaningful page titles: Clear, descriptive titles help Kapa provide more relevant answers
• Update regularly: Ensure your Notion content stays current, as Kapa will automatically sync with updates

Troubleshooting

• Authentication errors: Verify your integration token is valid
• Pages not appearing: Ensure you've properly shared pages with the integration
• Empty content: Some Notion elements like advanced blocks may not be fully captured
• Missing sub-pages: Confirm that parent pages are shared with the integration