---
title: Jira issue actions
source: https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/jira/jira-issue
---

This page provides a reference for Jira issue actions available in the workflow automation actions catalog. These actions enable you to create and manage issues in Jira Cloud.

## Prerequisites

Before using Jira actions in workflow automation, ensure you have:

-   A Jira Cloud instance with appropriate permissions.
-   A Jira API token for authentication.
-   The necessary permissions to create and manage issues in your Jira project.

In the action input, `authToken` must be provided. It is a Base64-encoded string of your `email:API_Token` and is used to authenticate requests to the Jira API using Basic Authentication.

## Set up API token authentication

For more information, see [Create and manage API tokens](https://id.atlassian.com/manage-profile/security/api-tokens) in the Atlassian documentation.

To generate and configure a Jira API token:

### Create a Jira API token

1.  Go to [Atlassian account security settings](https://id.atlassian.com/manage-profile/security/api-tokens).
2.  Click **Create API token**.
3.  Enter a label for the token and click **Create**.
4.  Copy the generated token value — it is shown only once.

### Create the Base64-encoded auth string

1.  Combine your Atlassian account email and the API token in the format `email:API_token`.
2.  Base64-encode the combined string.
3.  Store this value as a secret in your workflow automation configuration and reference it as `${{ :secrets:jiraAuthToken }}`.

## Available Jira issue actions

| Action name                                                                                                                                             | Description                                                          |
| ------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| [**Get a Jira issue**](https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/jira/jira-issue-get)                      | Retrieves the details of a specific Jira issue using its key.        |
| [**Search Jira issues**](https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/jira/jira-issue-search)                 | Searches for Jira issues using a JQL query string.                   |
| [**Get Jira issue transitions**](https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/jira/jira-issue-gettransitions) | Lists the available statuses to which the Jira issue can transition. |
| [**Update a Jira issue**](https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/jira/jira-issue-update)                | Updates an existing Jira issue.                                      |
| [**Create a Jira issue**](https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/jira/jira-issue-create)                | Creates a new Jira issue.                                            |
| [**Transition a Jira issue**](https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/jira/jira-issue-dotransition)      | Changes the status of the Jira issue.                                |