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

# Jira Cloud

> Connect a Jira Cloud site so that Datafold can file and update work items as an Atlassian service account.

> [!NOTE]
>
> Issue trackers are in preview and are enabled per organization. Ask your Datafold contact or [support@datafold.com](mailto:support@datafold.com) to turn them on.

Datafold files and updates Jira work items as an Atlassian service account, not as you. One Jira site connects to one Datafold organization.

Datafold supports Jira Cloud. Jira Data Center is not supported.

## 1. Create a service account and a credential

Your Atlassian organization must use centralized user management to create service accounts.

**1. Create a service account**

In [admin.atlassian.com](https://admin.atlassian.com), open **Directory** → **Service accounts** and create a service account.

**2. Give it access to Jira**

Give the service account access to Jira on your site, with a role that can create and edit work items in the projects that Datafold will use.

**3. Create an OAuth 2.0 credential**

Open the service account, choose **Create credentials** → **OAuth 2.0**, and select these scopes:

* `read:jira-work`
* `write:jira-work`
* `read:jira-user`

Copy the client ID and the client secret. Atlassian shows the secret only once.

## 2. Connect Jira in Datafold

Go to **Settings** → **Integrations** → **Issue Trackers**, click **Add new integration**, and choose **Jira**. Fill in the form and click **Connect**:

* **Site URL**: your Jira Cloud address, which must have the form `https://<name>.atlassian.net`.
* **Client ID**: the client ID of the service account's credential.
* **Client secret**: the client secret of the same credential.

Datafold checks the credential and its scopes before it saves them. The status then shows the site and the service account.

## Rotate the secret

If Jira refuses the credential (for example, after the secret is rotated or deleted), the page shows **Jira refused the credential**. Create a new OAuth 2.0 secret for the service account in admin.atlassian.com, enter it in the form with the same client ID, and click **Update credential**.

## Disconnect

**Disconnect** makes Datafold forget the credential. Atlassian cannot revoke the credential for Datafold, so delete the service account's OAuth 2.0 credential yourself in admin.atlassian.com. It stays valid until you do.


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