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

# Atlassian Jira

> Learn how to connect your Opal instance with Jira.

Opal's integration with Jira allows you to manage access to Jira groups.

## Supported resources

| Resource | Read | Grant and revoke access |
| - | - | - |
| Jira users | ✔️ | |
| Jira groups | ✔️ | ✔️ |

## Requirements

Before you begin, you must:

* Be an Opal Admin
* Be on version `1.1194.0`, if you self-host Opal

## 1. Create a Jira admin API key

To allow Opal to access your Jira users and groups and grant permission to assign and remove users from groups, you must first create an [Admin API key](https://support.atlassian.com/organization-administration/docs/manage-an-organization-with-the-admin-apis/).

In `admin.atlassian.com`, go to **Settings > API keys > Create API key** (choose an API key with scopes). Select the following scopes:

* `read:accounts:admin`
* `read:directories:admin`

## 2. Create a Jira API token

Opal uses a site-scoped API token to read and manage Jira groups. Go to `id.atlassian.com` > **Security > API tokens > Create API token with scopes** and select:

* `read:group:jira`
* `write:group:jira`
* `read:user:jira`

## 3. Create Jira app in Opal

In Opal, go to **Inventory** > **+App** and select **Jira**. Name your Jira app, select an **App admin**, provide a description, and enter your **Site Domain** (e.g., `yourcompany` for `yourcompany.atlassian.net`), **Org ID**, and **Admin API Key** from step 1 plus the **API Token** and admin **Email** from step 2. Opal validates the connection with the API token and email, so the app can't be created without them.

You can find your **Org ID** in the URL when you visit `admin.atlassian.com`:

`https://admin.atlassian.com/o/<your-org-id>/...`

After you save the app, you can import groups from **...** > **Import items**.

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.