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

# Aha!

> Learn how to connect Opal to Aha! to review account users and teams.

With the Aha! integration, you can see who can log in and which teams they belong to:

* Sync account users so Opal can match them to people in your identity provider
* Import teams and see who is on each team

## Supported resources

| Resource | Read | Grant and revoke access | Notes |
| - | - | - | - |
| Aha! users | ✔️ | | Synced as accounts. Deactivated accounts are not included. |
| Aha! teams | ✔️ | | Account members only. |

Opal does not sync products, product roles, or ideas-portal users.

## Requirements

* You must be an Opal admin.
* Be on version X or greater, if you self-host Opal.

## 1. Create a dedicated user and API key

Aha! ties every API key to a user. Opal does not support OAuth2. The [OAuth2](https://www.aha.io/api/oauth2) page is linked here only because it also explains how to use an API key. Use option 2:

> Create an Aha! user specifically for your application API access and assign it appropriate permissions and manage its API keys. This would just be another user in your Aha! account but you can use it like a "service account."

Open the user menu and go to **Settings → Personal → Developer → Generate API key**. The key is shown once. Calls run with that user's permissions. Opal lists account users, teams, and team memberships, so that user must be able to read those.

One key is one account. The account host is `https://{subdomain}.aha.io`.

## 2. Create an Aha! app in Opal

In Opal, go to **Inventory > +App** and select **Aha!**. Fill in the following fields and select **Create**.

| Field | Value |
| - | - |
| App name | A name for this account in Opal. |
| App admin | The team or user that should manage the Aha! app in Opal. |
| Description | What this account is, for people looking at the app. |
| Subdomain | The label before `.aha.io`. If the account URL is `acme.aha.io`, enter `acme`. |
| API key | The API key from [Step 1](#1-create-a-dedicated-user-and-api-key). |

## 3. Import Aha! teams

Account users sync as accounts on the app.

After creating the app, import teams from **... > Import items**.


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