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

Generate an API token in Atlassian under Account Settings → Security → API tokens.

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

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

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)