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

# Confluence

## Required Scopes

To configure a Sync for Confluence, you need to request the following scopes from your Atlassian OAuth application:

* `read:page:confluence`
* `read:space:confluence`
* `read:confluence-content.all`
* `read:content:confluence`
* `read:content-details:confluence`
* `read:confluence-content.summary`
* `read:hierarchical-content:confluence`
* Required for permissions sync:
  * `read:confluence-content.permission`
  * `read:confluence-space.permission`
  * `read:confluence-groups`
  * `read:email-address:confluence`
  * `read:user:confluence`

Learn more about configuring scopes for your app in [Adding Integrations](/getting-started/adding-an-integration#create-a-developer-app).

## Synced Objects

Confluence supports the following Synced Objects:

* [Files](/managed-sync/api/file-schema): Pages in Confluence will be synced as HTML files.
* [Permissions](/managed-sync/permissions-api): Permissions for pages and spaces will be synced, including spaces, groups, and page-level restrictions.

## Files

Send a request to [Enable Sync](/managed-sync/api/enable-a-sync) to start a file sync.

Syncs for Confluence can be created with one of the following configurations:

* **Space Sync**: All pages in the specified space will be synced.
* **Sync of specific pages**: A group of specific pages and their descendants will be synced.
* **Sync of one page**: A specific page and its descendants will be synced.

<Tabs>
  <Tab title="Space Sync">
    ```json Example theme={null}
    {
        "integration": "confluence",
        "pipeline": "files",
        "configuration": {
            "spaceId": "123456789"
        }
    }
    ```

    **Configuration options:**

    <ParamField path="spaceId" type="string" required>
      A Confluence Space ID to limit the Sync scope to pages within a specific space.
    </ParamField>
  </Tab>

  <Tab title="Sync of specific pages">
    ```json Example theme={null}
    {
        "integration": "confluence",
        "pipeline": "files",
        "configuration": {
            "pageIds": ["987654321"]
        }
    }
    ```

    **Configuration options:**

    <ParamField path="pageIds" type="string[]" required>
      A list of Confluence Page IDs to limit the Sync scope to. All specified pages and their descendants will be synced.
    </ParamField>
  </Tab>

  <Tab title="Sync of one page">
    ```json Example theme={null}
    {
        "integration": "confluence",
        "pipeline": "files",
        "configuration": {
            "pageId": "987654321"
        }
    }
    ```

    **Configuration options:**

    <ParamField path="pageId" type="string" required>
      A Confluence Page ID to limit the Sync scope to a specific page and its descendants.
    </ParamField>
  </Tab>
</Tabs>