Notion

Connect Notion workspaces to enable AI-powered documentation search and automated updates

Notion is an all-in-one workspace that combines notes, documents, databases, and project management. Connecting Notion to Harmony enables your AI agents to access organizational knowledge, provide context-aware support responses, and automatically update documentation based on support interactions.

Once connected, Harmony syncs your Notion pages and keeps the knowledge base up to date so your agent always has access to the latest information. This integration is available alongside existing knowledge base options, giving you more flexibility in how you structure and maintain your support content.

What the Notion integration enables

Capability	Description
Knowledge Base Access	Search and retrieve information from Notion pages and databases
AI-Powered Search	Harmony AI can query Notion content to answer user questions
Documentation Sync	Keep runbooks and IT documentation in sync with support activities
Wiki Integration	Surface relevant Notion content during ticket resolution
Selective Sync	Choose specific Notion spaces and databases to control what is indexed

Prerequisites

• Notion Workspace Admin: Ability to create and manage integrations
• Notion API Access: Workspace with API access enabled
• Harmony Account: Active Harmony workspace

Connect Notion to Harmony

Step 1: Navigate to Integrations

1. Log in to your Harmony dashboard
2. Go to Settings > Integrations
3. Find Notion under Knowledge Base and click Connect

Click Connect to authenticate Notion

Step 2: Start Authentication

1. Click Connect to start the authentication process

Notion authorization page

Step 3: Authorize Harmony

1. You'll be redirected to Notion's authorization page
2. Review the permissions Harmony will have:

   • View pages you select
   • View workspace users and their emails
3. Click Select pages to choose which pages to share
4. Select the pages or databases you want Harmony to access
5. Click Allow access to complete the connection

Navigate to Notion integration in Harmony dashboard

Configure Sync Settings

After connecting, you can fine-tune what Harmony syncs from your Notion workspace to keep your knowledge base focused and up to date.

Select Notion Spaces to Sync

Rather than syncing your entire workspace, you can choose which Notion spaces to include. This ensures only relevant content is indexed and prevents unnecessary data from appearing in your knowledge base.

1. Go to Settings > Integrations and open your Notion connection
2. Under Spaces, select the spaces you want Harmony to sync
3. Save your changes - existing setups continue to work without any changes needed

Select Specific Databases to Sync

You can also control which Notion databases are included in your knowledge base sync.

1. In your Notion integration settings, locate the Databases section
2. Use the multi-select picker to choose one or more databases to sync
3. Leave the selection empty to sync all databases - this preserves the existing default behaviour
4. Save your changes

Selecting specific databases reduces unnecessary sync time for large workspaces and gives you precise control over what content Harmony indexes.

What Harmony Syncs

From Notion:

• Page content and titles
• Page hierarchy and relationships
• Database schemas and records
• Last updated timestamps
• Page URLs and references
• User mentions and comments

Sync Performance

Harmony's Notion sync is built to handle large workspaces reliably. Key improvements include:

• Large workspace syncs no longer stall due to Notion API rate limits
• Selecting specific spaces and databases reduces sync scope and speeds up indexing
• Existing setups continue to work without any configuration changes

Use Cases

Intelligent Support Responses

Use Notion as your AI's knowledge base for answering user questions

Automated Documentation

Keep documentation current with resolved tickets and new solutions

Self-Service Portal

Empower users with instant access to Notion knowledge during conversations

Asset Management

Query Notion databases for hardware, software, and license information