> ## 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

<Badge icon="arrow-left" color="gray">[Back to the list of Connectors](/agent-platform/knowledge#connectors)</Badge>

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.</Note>

## 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.                                    |
| 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.