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

# Confluence

> Learn how to connect your Opal instance with Confluence.

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

## Supported resources

| Resource          | Read | Grant and revoke access |
| ----------------- | ---- | ----------------------- |
| Confluence users  | ✔️   | ✔️                      |
| Confluence 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 Confluence admin API key

To allow Opal to access your Confluence 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**. Select the following scopes:

* `read:user:admin`
* `read:directory:admin`

## 2. Create a Confluence API token

In `id.atlassian.com`, go to **Security > Api Tokens > Create API Tokens**. Select the following scopes:

* `read:group:confluence`
* `write:group:confluence`
* `read:user:confluence`

## 2. Create Confluence app in Opal

In Opal, go to **Inventory** > **+App** and select **Confluence**. Name your Confluence app, provide a description, and enter the admin API key and API token you generated in step 1. Enter your Site Domain (e.g. yourcompany for yourcompany.atlassian.net).

You will also need your Org ID, which is visible in the URL when you visit admin.atlassian.com:

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

And finally the admin email of the admin user that created the admin API key in step 1

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

***