> For the complete documentation index, see [llms.txt](https://helpcenter.gitprotect.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.gitprotect.io/backup-and-recovery/confluence/integration/adding-a-confluence-instance-to-gitprotect.md).

# Adding a Confluence instance to GitProtect

Learn how to integrate Confluence with GitProtect using an API token.

**Adding Confluence to GitProtect allows organizations to secure business documentation and knowledge base resources against accidental deletion, data corruption, ransomware incidents, and configuration issues while supporting automated backup operations, granular restore capabilities, and long-term data retention management across cloud environments.**

***

## Integration process

The below steps demonstrate how to quickly integrate **Confluence** with **GitProtect** using **GitProtect Management Service**.

{% hint style="danger" %}
For **Confluence**, use a classic token — **GitProtect does not support scoped tokens**.
{% endhint %}

{% hint style="warning" %}
Before adding **Confluence** to **GitProtect**, [check if your account has the required permissions](/backup-and-recovery/confluence/integration/required-permissions.md) for all spaces you want to protect.
{% endhint %}

{% stepper %}
{% step %}
Open the **DevOps** tab on the left side of the window and select **Confluence** from the list.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2F7YJdiH5JR80cm3Rxzj9p%2Fadding_Confluence_to_XONE_1.png?alt=media&amp;token=586c29e0-0232-4664-85a1-b4263c391012" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click the **Connect** button under **Confluence Software**.

{% hint style="info" %}
If you already have a **Confluence** instance added, click the **+ Add new** button in the top-left corner first.
{% endhint %}

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FG8vneDTr58QujMICw7wl%2Fadding_Confluence_to_XONE_2.png?alt=media&amp;token=7e26146b-12a4-4f16-a05b-99ccf0dabe5a" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
In settings, enter the **Atlassian** organization address (for example, <kbd><https://mycompany.atlassian.net></kbd>) and add or select an API token from the **Password Manager**.

{% hint style="success" %}
**GitProtect** can secure organizations that have a custom domain configured, but the organization must be added using its original URL, which can be found in <https://admin.atlassian.com> > **Apps** > **App URLs** > **Custom domains** > **Actions** > **Show details**.
{% endhint %}

{% hint style="info" %}
Learn more about custom domains in [this article](/backup-and-recovery/confluence/integration/custom-domains.md).
{% endhint %}

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2Fb9uc6bbSyzUlymaclELK%2Fadding_Confluence_to_XONE_3.png?alt=media&amp;token=bf4e1d1d-15b4-4c89-9b33-0bb1207baa59" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Configure the organization synchronization and the default worker. Specify the synchronization start time or set a time interval for automatic updates.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FVayfBChJMS6X1NFJ45Gb%2Fimage.png?alt=media&amp;token=d6eed1d2-4b3c-4b16-9789-efa80afd4e49" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **Proceed** to complete the process of adding **Confluence** to **GitProtect** and granting it access to the specified resources.
{% endstep %}

{% step %}
Your **Confluence** instance has been successfully added to **GitProtect**. Click **Custom policy** to modify the backup policy settings, or click **Run backup** to start the backup immediately using the default policy configuration.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FancpabMqVOeQXlxLgt1U%2Fadding_Confluence_to_XONE_5.png?alt=media&amp;token=5df6118c-bf34-4f91-aa9f-d9d1d157406f" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Useful links and items

{% content-ref url="/pages/UMokHj0JbSCHRkwROBNf" %}
[Required permissions](/backup-and-recovery/confluence/integration/required-permissions.md)
{% endcontent-ref %}

{% embed url="<https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/>" %}
