> 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/confluence.md).
# Confluence
Power Harmony AI with Confluence knowledge to deliver intelligent, context-aware support responses
Confluence is Atlassian's team collaboration and knowledge management platform that provides a centralized space for creating, organizing, and sharing documentation. Connecting Confluence to Harmony enables your AI to access your organization's knowledge base, providing accurate and contextual responses to IT support requests.
Harmony connects to Confluence via OAuth, so setup is fast and secure - no API tokens required. Confluence is its own dedicated integration, independent from Jira Service Management, so you can authorize each separately based on your needs.
### What the Confluence integration enables
| Capability | Description |
| -------------------------- | --------------------------------------------------------------------------- |
| Knowledge Base Sync | Import selected Confluence spaces and pages to power Harmony's AI responses |
| Intelligent Search | Find relevant documentation instantly within support conversations |
| Contextual Responses | AI provides answers based on your actual IT documentation |
| Automated Documentation | Create and update Confluence pages from Harmony workflows |
| Permission-Aware Retrieval | Respect Confluence space and page permissions when surfacing articles |
| Real-Time Updates | Keep AI knowledge current with automatic page sync |
### Prerequisites
* **Atlassian Cloud Admin Access**: Site admin or org admin role
* **Confluence Instance**: Active Confluence Cloud instance (on-premises Confluence is not supported)
* **Harmony Account**: Active Harmony workspace
### Connect Confluence to Harmony
#### Step 1: Navigate to Integrations
1. Log in to your Harmony dashboard
2. Go to **Settings** > **Integrations**
3. Find **Confluence** under **Knowledge Base** and click its card
#### Step 2: Start Authentication
1. Click **Connect** to start the OAuth authentication process
#### Step 3: Authorize in Atlassian
1. You will be redirected to Atlassian's login page
2. Enter your Atlassian account email
3. Complete the authentication process
4. On Atlassian's consent screen, select your Confluence site and authorize Harmony to access it
#### Step 4: Select Confluence Spaces to Sync
After authorizing, you return to Harmony and the integration window says "OAuth authentication completed successfully. Please provide the following configuration details to complete the connection." Harmony fetches your available Confluence spaces - including both KB-type and global spaces. You can select exactly which spaces to include in your Harmony Knowledge Base rather than ingesting your entire Confluence tenant.
1. Open the spaces list ("Select the spaces you want to integrate with.")
2. Select one or more spaces you want Harmony to sync (at least one is required)
3. Click **Complete Configuration**
Only content from your chosen spaces will be indexed, keeping your Knowledge Base focused and relevant to your support workflows. You can update your space selection at any time by clicking the **Confluence** card and clicking **Save Changes**.
### Connect with an API token instead
If you prefer not to use OAuth, connect the **Confluence (API Token)** integration instead.
1. In Atlassian, go to [API tokens](https://id.atlassian.com/manage-profile/security/api-tokens), click **Create API token**, enter a name and an expiration date, click **Create**, and copy the token
2. In Harmony, go to **Settings** > **Integrations** and click the **Confluence (API Token)** card under **Knowledge Base**
3. Enter:
* **Instance URL**: your Confluence Cloud URL, for example `https://yourcompany.atlassian.net/wiki`
* **Username**: the email address of the Atlassian account that created the token
* **API token**: the token you copied
4. Click **Connect**
5. In the spaces list that appears, select the spaces to sync and click **Save Changes**
Harmony reads the content that this Atlassian account can see. When the token expires, click the **Confluence (API Token)** card, click **Replace** next to **API token**, paste the new token and click **Save Changes**.
### What Harmony Syncs
**From Confluence:**
* Confluence pages and spaces (limited to your selected spaces)
* Page content, titles, and hierarchy
* Page metadata and last updated timestamps
* Space-level and page-level permission rules
### Permission-Aware Knowledge Base Retrieval
When Harmony syncs your Confluence content, it captures both space-level access rules and page-level restrictions, then uses that information to filter knowledge base results at query time. This ensures your AI agents only surface content that a user is actually authorized to see.
* **Space-level permissions**: Users and groups who can access a Confluence space are synced and respected - users without space access will never see content from that space in Harmony responses.
* **Page-level restrictions**: Any additional restrictions applied to individual pages are also captured and enforced, so restricted pages are only surfaced to users with explicit access.
No additional configuration is required - permission filtering happens automatically as part of the sync process.
### Use Cases
Knowledge Base Integration
Surface Confluence articles during AI-powered support conversations
Intelligent Responses
AI provides answers based on your actual Confluence documentation
Automated Documentation
Create and update Confluence pages from ticket resolutions
Self-Service Portal
Empower users with instant access to Confluence knowledge
---
# 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/confluence.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.