> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/integrations/knowledge-base/notion.md).
# Notion
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**
**Step 2: Start Authentication**
1. Click **Connect** to start the authentication process
**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
#### 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
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.harmony.io/integrations/knowledge-base/notion.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.