> For the complete documentation index, see [llms.txt](https://docs.duplocloud.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.duplocloud.com/docs/getting-started/integrating-providers/jira.md).

# Jira

Connecting Jira to DuploCloud lets the AI agent read tickets, create issues, update statuses, and act on Jira data on your behalf. You will need an Atlassian API token, your account email, and your Jira Cloud ID.

***

## Step 1 — Add the Jira Provider

In DuploCloud, go to **Providers** in the left sidebar, select your tenant (e.g. **IT**), and click the **Other** tab. Click **+ Add**.

![Other providers list](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fgit-blob-485f8a493b31824da45f78491273b7c583670918%2Fjira-step-01.png?alt=media)

Fill in the **Add Provider** form:

* **Name** — a name for this provider (e.g. `Jira-test`)
* **Type** — select `Other`
* **Account ID** — your Atlassian domain (e.g. `your-org.atlassian.net`)

Click **Create Provider**.

![Add Provider form](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fgit-blob-b81575af74a59dc940ca848bcce71885dc8abc8e%2Fjira-step-02.png?alt=media)

The provider is created and you are taken to the provider detail page.

![Provider created successfully](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fgit-blob-c5d198f83981598ecabea3570363457d45af97c6%2Fjira-step-03.png?alt=media)

***

## Step 2 — Add a Credential

On the **Credentials** tab, click **+ Add**. Add the following credential fields:

* **`apikey`** — your Atlassian API token. Generate one at **id.atlassian.com** → **Security** → **API tokens** → **Create API token**. Set Sensitive to on.
* **`username`** — the email address associated with your Atlassian account
* **`CloudID`** — your Jira Cloud ID. To find it, navigate to `https://your-domain.atlassian.net/_edge/tenant_info` in your browser — the `cloudId` field in the response is the value to use here

Click **Create**.

![Add Credential with apikey, username, and CloudID](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fgit-blob-087562878fd097db2eab51388d19f7ae92b1b8ba%2Fjira-step-04.png?alt=media)

***

## Step 3 — Add a Scope

On the **Scope** tab, click **+ Add**.

* **Name** — a name for this scope (e.g. `Jira-test-scope`)
* **Credential** — select the credential you just created

Click **Create**.

![Add Scope modal](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fgit-blob-a53b08b61f1dce0c9b5dd677d4e79c4107f5a1bc%2Fjira-step-06.png?alt=media)

***

## Step 4 — Use the Scope in a Ticket

Go to **HelpDesk** and create a new ticket. In the scope selector, choose the Jira scope from the dropdown.

![Scope dropdown with Jira-test-scope selected](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fgit-blob-5826df455624ad0547ff340c31823aef6cd1cfa9%2Fjira-step-07.png?alt=media)

Type your request and click **Create Ticket**.

![Ticket ready with Jira scope](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fgit-blob-d229b9897b3442ed738e7e9412d8e5465dac2671%2Fjira-step-08.png?alt=media)

***

## Step 5 — Output

The agent authenticates with your Jira instance and executes the request. Results appear in the ticket thread.

![Agent reading and acting on Jira tickets](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fgit-blob-87b920a80e30e3cf772e1fcb0da4bccda27c36b5%2Fjira-step-09.png?alt=media)

![Both tickets transitioned to Done](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fgit-blob-ac66646f4667508b3d6a7460156a70732be2e3aa%2Fjira-step-10.png?alt=media)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.duplocloud.com/docs/getting-started/integrating-providers/jira.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.