> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Confluence Cloud connector

[Back to list of knowledge sources](https://koreai.mintlify.site/agent-platform/integrations/knowledge-sources.md)

The Confluence Cloud Connector integrates Search AI with your Atlassian Confluence Cloud account, enabling intelligent search over your organization’s knowledge articles using OAuth 2.0 authentication.

## Specifications

| Specifications | Details |
| - | - |
| Supported content | Pages, Blog Posts, Attachments, Comments |
| Permission-aware ACL support | Yes |
| Content filtering | Yes |

> [!NOTE]
>
> Attachments and comments are synchronized only for the selected parent content. When permission-aware ACLs are enabled, search results respect the permissions configured in Confluence Cloud.

## Prerequisites

Ensure that:

* You have access to the Confluence Cloud sites you want to index.

* You have the required permissions to access content in the Confluence Cloud instance.

* If using webhook-based synchronization, ensure that webhook integration is configured for the Confluence Cloud site.

* Create an [Atlassian OAuth application](https://developer.atlassian.com/cloud/confluence/oauth-2-3lo-apps/#oauth-2.0-\(3lo\)-apps) and authorize it with the required scopes. The Confluence Cloud connector requires the following OAuth scopes:

  * `read:space:confluence`
  * `read:page:confluence`
  * `read:blogpost:confluence`
  * `read:attachment:confluence`
  * `read:comment:confluence`
  * `read:content-details:confluence`
  * `read:user:confluence`
  * `read:email-address:confluence`
  * `read:jira-user`
  * `read:group:confluence`
  * `read:space.permission:confluence`
  * `search:confluence`
  * `offline_access`

* Create an Atlassian OAuth Profile under `Project Settings > Auth Profiles` before configuring the connector.

## Connector configuration

### Connection

Specify the Confluence Cloud site and authentication settings.

| Field | Description |
| - | - |
| Atlassian OAuth profile | Specifies the OAuth profile used to connect to the Confluence Cloud instance. Use an existing auth profile or create a new one. |
| New OAuth profile | Creates a new Atlassian OAuth profile. |
| Discover sites | Discovers Confluence Cloud sites available using the selected OAuth profile. |
| Confluence site | Specifies the Confluence Cloud site to synchronize. |
| Required OAuth coverage | Displays the OAuth scopes required by the connector. |

### Scope and filters

Select the content to synchronize and configure content filters.

| Field | Description |
| - | - |
| Pages | Synchronizes Confluence pages. |
| Blog posts | Synchronizes Confluence blog posts. |
| Attachments | Synchronizes attachments associated with the selected pages and blog posts. |
| Space keys | Specifies one or more Confluence spaces to synchronize. |
| Discovered spaces | Displays the spaces discovered from the selected Confluence site. |
| Content filters | Selects the content type for which filters are configured. Select All content types to set common filters that apply to all content types. |
| Modified after | Synchronizes content modified after the specified date. |
| Modified before | Synchronizes content modified before the specified date. |
| Ancestor page IDs | Restricts synchronization to content under the specified parent pages. |
| Attachment formats | Specifies the attachment formats to synchronize. |
| Include comments | Synchronizes comments associated with the selected pages and blog posts. |
| Include archived content | Includes archived pages and blog posts during synchronization. |
| Advanced CQL Override | Specifies a Confluence Query Language (CQL) query to further filter the content synchronized. |

### Permissions

Configure permission-aware synchronization. When enabled, Confluence permissions are synchronized and enforced during search so that users only see the knowledge content that they're authorized to access.

| Field | Description |
| - | - |
| Permission-aware ACL | Synchronizes Confluence access permissions and applies them to search results. |

Generate a Proposal Preview and optionally run a Dry Run to validate the connector configuration before starting the initial synchronization. Once you have verified the configuration, select **Approve & Start** to activate the connector.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.