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

# ActiveCampaign

> Learn how to connect Opal to ActiveCampaign to review account users and permission groups.

With the ActiveCampaign integration, you can see who can log in and which permission groups they belong to:

* Sync account users so Opal can match them to people in your identity provider
* Import permission groups and review who is in each group

## Supported resources

| Resource | Read | Grant and revoke access | Notes |
| - | - | - | - |
| ActiveCampaign users | ✔️ | | People who can log in. Synced as accounts. |
| ActiveCampaign groups | ✔️ | | Permission groups. |

Contacts, marketing lists, CRM accounts, and deal groups are separate ActiveCampaign resources. Opal does not sync them.

## Requirements

* You must be an Opal admin.
* You need the API URL and API key from the ActiveCampaign account you want to review.

ActiveCampaign does not publish a scope list for this key. The key acts as the user who owns it, and that user's groups decide what the key can read. Opal needs that user to be able to list account users and permission groups. The published reference requires the Admin group only for account settings, which Opal does not call. If the key's user cannot list users or groups, the connection check fails.

## 1. Copy the API URL and API key

In ActiveCampaign, go to **Settings → Developer**. ActiveCampaign documents the API URL and API key on the [Authentication](https://developers.activecampaign.com/reference/authentication) page.

Copy the **API URL** on that page. Use the URL as shown. The host belongs to that account, and it is not always `api-us1.com`. Building a host from the account name points Opal at the wrong account for some customers. One URL is one hosted account. To review a second account, create a second app.

Copy the **API key** next to that URL. Each user has their own key, and the key acts as that user. Copy it from this account's Developer page.

> [!NOTE]
>
> A Partner Portal key is a different API. Opal does not accept it.

## 2. Create an ActiveCampaign app in Opal

In Opal, go to **Inventory > +App** and select **ActiveCampaign**. 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 ActiveCampaign app in Opal. |
| Description | What this account is, for people looking at the app. |
| API URL | The API URL from [Step 1](#1-copy-the-api-url-and-api-key). It must start with `https://`. |
| API token | The API key from Step 1. |

Opal checks the API URL, then calls the current-user endpoint with the key, then lists account users and permission groups. The app is saved only when those checks succeed.

## 3. Import permission groups

Account users sync as accounts on the app. Opal matches them by email. A user with no email, or an email Opal cannot parse, is skipped.

Import permission groups from **... > Import items**. Opal reads each group's name, description, and members. You can include those groups in an [access review](https://docs.opal.dev/docs/access-campaigns.md).


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