> 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
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 to control what is indexed |
#### Prerequisites
* **Notion Account**: A workspace member or owner with full access to the pages you want Harmony to read. Members and workspace owners can both add connections; on Enterprise plans, workspace owners can restrict which connections members can add
* **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 its card
**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. Notion lists only the pages and databases you have full access to
5. Click **Allow access** to complete the connection
**Step 4: Complete the Configuration**
You return to Harmony and the integration window says "OAuth authentication completed successfully. Please provide the following configuration details to complete the connection."
1. Optionally, select the Notion spaces you want Harmony to sync. If you select none, Harmony syncs everything you shared with it in Step 3
2. Click **Complete Configuration**
#### 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 click the **Notion** card
2. In the spaces picker ("Select the spaces you want to sync."), select the spaces you want Harmony to sync
3. Click **Save Changes** - existing setups continue to work without any changes needed
#### 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
#### 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 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.