> For the complete documentation index, see [llms.txt](https://helpcenter.xopero.com/xopero-one-en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.xopero.com/xopero-one-en/backup-and-recovery/jira/integration/adding-jira-organization-to-xopero-one.md).

# Adding Jira organization to Xopero ONE

#### Adding Jira organization to Xopero ONE connects your environment to the platform so you can start protecting its data.

***

## Using an API token

{% hint style="danger" %}
For **Jira**, use the classic token — **Xopero ONE does not support scoped tokens**.
{% endhint %}

{% hint style="warning" %}
Before adding your **Jira** organization to **Xopero ONE**, [check if your account has the required permissions](/xopero-one-en/backup-and-recovery/jira/integration/required-permissions.md) for all spaces you want to protect.
{% endhint %}

{% stepper %}
{% step %}
Log in to [**XMS**](#user-content-fn-1)[^1], open the **DevOps** tab on the left side of the window, and select **Jira** from the list.

<figure><img src="/files/bYvhS5COubawW4888AF9" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click the **Connect** button under **Jira Software** or **Jira Service Management** (depending on your needs).

<figure><img src="/files/XFNs2P9DzhTQAd0Wx3lT" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Enter your **instance URL** (for example, <kbd><https://mycompanyjira.atlassian.net></kbd>) and your **Jira** login, then add or select an [API token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/#Create-an-API-token) from the **Password Manager**.

{% hint style="success" %}
**Xopero ONE** 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](/xopero-one-en/backup-and-recovery/jira/integration/custom-domains.md).
{% endhint %}

<figure><img src="/files/TWa37Vq6kO6TxGJsiq6D" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Configure your spaces sync and default worker — specify hours for synchronization, or set a time interval for automatic updates. Once done, click **Proceed**.

{% hint style="warning" %}
The account used for the authorization process must have **at least site admin permissions**.
{% endhint %}

<figure><img src="/files/PoCSbRl08L7TUwhFwXhf" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Your **Jira** organization has now been successfully added to **Xopero ONE** — click **Custom policy** to adjust your backup policy settings, or click **Run backup** to execute the backup immediately using the current policy configuration.

{% hint style="info" %}
Granular backup is the default policy configuration applied to any new **Jira** organization you add to **Xopero ONE**.
{% endhint %}

<figure><img src="/files/7s6HyIJmBaIdm5nDwLhD" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Useful links and items

{% content-ref url="/pages/oPby9dY2jLkx7Wyb0G20" %}
[Required permissions](/xopero-one-en/backup-and-recovery/jira/integration/required-permissions.md)
{% endcontent-ref %}

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

[^1]: Xopero ONE Management Service