Skip to main content
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.
  • 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.

​
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 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.

​
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 documentation.

​
Common issues