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

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

3. Import Aha! teams

Account users sync as accounts on the app. After creating the app, import teams from … > Import items.
Last modified on November 16, 2026