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

# Integrate Jira Actions

Use the Jira integration to enable Artemis agents to perform actions on Jira Cloud through Action Tools. Before creating a Jira Action Tool, configure an OAuth authentication profile that allows Artemis to securely access your Jira Cloud instance.

## Prerequisites

Before you begin, ensure you have:

* A Jira Cloud site with administrator access.
* An [Atlassian Developer account](http://developer.atlassian.com).
* Permission to create OAuth 2.0 (3LO) applications in Atlassian.
* An Artemis project with permission to create Integration Profiles and Action Tools.

## Step 1: Create a Jira OAuth 2.0 application

1. Sign in to the **Atlassian Developer Console**.
2. Create a new **OAuth 2.0 (3LO)** application.
3. Configure the required OAuth scopes for the Jira APIs your agent will use. The required scopes are also listed in the auth profile creation page in Artemis.
4. Copy the **Callback URL** displayed in the Artemis authentication profile (created in Step 2) and add it as an **Authorized Redirect URI** in the Atlassian application.
5. Save the application.
6. Copy the generated **Client ID** and **Client Secret**. These will be required when creating the authentication profile.

For detailed instructions, see the [Atlassian documentation](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/).

## Step 2: Create a Jira integration profile for authentication

1. In Artemis, navigate to **Integrations**.
2. Select **Jira**. The page lists all the supported actions and triggers. Click **Connect**.
3. This takes you to the auth profile creation page.
4. Select **OAuth App** as the authentication type. Refer to [this](/agent-platform/administration/integrations-settings#auth-profiles) for more details on creating an auth profile.
5. Enter the client ID and secret.
6. Ensure that:
   1. The scopes listed in the auth profile page are enabled for the app in the Atlassian account.
   2. The redirect URI configured in the Atlassian OAuth app matches the URI shown in this profile page. Click **Create Profile**.

After creating the profile:

1. Click **Authorize** to test the Jira configuration.
2. Sign in to your Atlassian account when prompted.
3. Review and approve the requested permissions.
4. After authorization completes successfully, verify that the auth profile status changes to **Active**.

## Step 3: Create a Jira action tool

1. Navigate to **Tools**.
2. Click **New Tool** → **Action Tool**.
3. Choose **Jira** as the integration.
4. Select the required Jira action.
5. Select the configured Jira authentication profile.
6. Configure the required input and output parameters.
7. Save the tool.

[Learn More about Action Tools](https://docs.kore.ai/agent-platform/tools/actions).

## Step 4: Use the action tool

After the Action Tool is created, you can add it to your agent and invoke it during conversations.

For information about configuring tool inputs, outputs, and runtime behavior, see the [Tools](/agent-platform/tools/actions#assign-an-action-to-an-agent) documentation.

## Common issues

| **Issue**                                | **Resolution**                                                                                                                                                   |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Authorization fails or does not complete | Verify that the **Callback URL** configured in the Atlassian OAuth application exactly matches the Callback URL displayed in the Artemis authentication profile. |
| Authentication window remains pending    | Complete the OAuth consent flow in the same browser session and ensure the callback URL is reachable.                                                            |
| Invalid client credentials               | Verify that the **Client ID** and **Client Secret** are copied correctly from the Atlassian Developer Console.                                                   |
| API calls fail after authentication      | Confirm that the OAuth application includes all required Jira API scopes for the actions your agent performs.                                                    |