←back to manuals

Notion Integration

Notion Integration allows you to connect your Notion workspace to ChatBotKit, automatically syncing pages, databases, and content into datasets. This enables your AI agents to access and search your Notion knowledge base, making it easy to build chatbots that can answer questions based on your documentation, wikis, and organizational knowledge.

Creating a Notion Integration

To create a Notion integration, you need to provide a Notion API token and specify which dataset should receive the synced content. The integration will automatically discover and sync all accessible pages and databases from your Notion workspace.

You can configure the sync schedule to control how frequently your Notion content is updated in the dataset. The integration supports various sync frequencies from real-time to daily updates, ensuring your AI agents always have access to the latest information.

Important: The Notion API token must have read access to the pages and databases you want to sync. You can create an integration token in your Notion workspace settings and grant it access to specific pages.

The syncSchedule parameter accepts cron expressions to control sync timing. Common patterns include hourly ("0 * * * *"), daily ("0 0 * * *"), or custom schedules based on your needs.

The expiresIn parameter specifies how long synced records should be retained before automatic expiration, helping manage storage costs for frequently changing content. Set to null for permanent retention.

Listing Notion Integrations

Retrieve all Notion integrations configured in your account to manage sync configurations, monitor status, and access integration details. This endpoint provides a complete inventory of all Notion workspace connections and their synchronization settings.

The list includes all configuration details except for sensitive API tokens, which are masked with "********" for security. Each integration entry shows which dataset it syncs into, the sync schedule, and expiration settings.

Query Parameters:

  • cursor: Pagination cursor for retrieving additional results
  • order: Sort order ("asc" or "desc", default: "desc")
  • take: Number of integrations to retrieve (default: 25)
  • meta: Filter by metadata key-value pairs
  • blueprintId: Filter integrations by blueprint association

The response includes complete integration configurations, enabling you to audit your Notion connections, verify sync schedules, and identify which datasets receive content from each workspace.

Example Response:

notionintegrationsync