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

# Jira

> This page outlines how to use the Jira integration for issue tracking in Cargo.

Jira is a project management and issue tracking platform by Atlassian, widely used for agile software development and team collaboration. Cargo's native integration with Jira allows you to create and retrieve issues directly from your workflows.

## How to set up Jira

To connect Jira, you'll need your domain, email, and an API key.

### Connection details

| Field           | Description                                                         |
| --------------- | ------------------------------------------------------------------- |
| **Jira Domain** | Your Jira subdomain (e.g., `mycompany` for mycompany.atlassian.net) |
| **User Email**  | Your Jira user email address                                        |
| **API Key**     | Your Jira API token                                                 |

<Tip>Generate an API token in Atlassian under **Account Settings → Security → API tokens**.</Tip>

Once the connector is created, you can:

* **Use Jira in workflows** — Choose **Jira** from the node catalog within a **Play**, **Tool**, or **Agent**.

***

## Jira actions

### Create Issue

Create a new issue in a Jira project.

**Use cases**

* **Bug tracking** – Create issues from customer support tickets or error alerts
* **Feature requests** – Turn qualified leads into product feature requests
* **Task automation** – Create tasks based on workflow triggers

**Configuration**

| Field             | Description                        |
| ----------------- | ---------------------------------- |
| **Project Key**   | The project to create the issue in |
| **Issue Type**    | Bug, Task, Story, Epic, etc.       |
| **Summary**       | Issue title/summary                |
| **Description**   | Detailed description               |
| **Custom Fields** | Additional project-specific fields |

<Info>Custom fields vary by project and issue type. Cargo automatically loads available fields based on your selection.</Info>

### Get Issue

Retrieve an existing issue by its ID or key.

**Use cases**

* **Status lookup** – Check issue status before taking action
* **Data enrichment** – Pull issue details into workflows
* **Conditional routing** – Route based on issue properties

**Configuration**

| Field               | Description                           |
| ------------------- | ------------------------------------- |
| **Issue ID or Key** | The issue identifier (e.g., PROJ-123) |