## ActiveCampaign integration

[ActiveCampaign](https://www.activecampaign.com/) is a marketing automation and CRM platform for email campaigns, automations, contact management, and sales pipelines. Integrating ActiveCampaign with Frontegg lets your application read and manage contacts, lists, campaigns, automations, deals, and tags on behalf of a connected ActiveCampaign account through the [ActiveCampaign API v3](https://developers.activecampaign.com/reference). Authentication is API key, sent on every request as the `Api-Token` header.

Prerequisites
- An [ActiveCampaign](https://www.activecampaign.com/) account with access to the account's **Settings → Developer** page (account admins).


### Connect ActiveCampaign

#### Step 1: Open the Developer settings

Sign in to your ActiveCampaign account at `https://<your-account>.activehosted.com`, then open **Settings** (the gear icon) and select **Developer** from the settings menu. This page hosts the **API Access** section, which contains both values the integration needs: your API URL and your API key.

![ActiveCampaign Settings menu with the Developer item highlighted](/assets/activecampaign-1.ff3007be896915de3ffe0518e95d93084cf66cb996c871199a0e3b6247b18826.1ce25488.png)

#### Step 2: Copy your API URL and key

In the **API Access** section, locate the **URL** and **Key** fields:

- **URL** — has the form `https://<accountName>.<region>.com` (for example, `https://yourcompany.api-us1.com`). The first part is your **account name** (the subdomain, e.g. `yourcompany`) and the second part is your **region** (e.g. `api-us1`). Note both — you will enter them in the Frontegg portal.
- **Key** — your **API key**, sent as the `Api-Token` header. Use the **Copy API Key** button to copy it.


![ActiveCampaign Developer page showing the API Access URL and Key](/assets/activecampaign-2.9230afd875a3c3f2391c2e642a225545e6b30300ecb864334906beadcb0ceadc.1ce25488.png)

Keep your API key secret
Treat the API key like a password. Anyone with the key has full access to your account data. If it is ever exposed, use **Reset API Key** on the Developer page to revoke the old key and issue a new one. Never commit the key to version control or expose it in client-side code.

### Configure the Frontegg portal

Once you have your **API key**, **account name**, and **region**, enter them in the Frontegg portal:

1. Open the **Frontegg portal** and navigate to **[Environment]** → **Integrations** → **ActiveCampaign**.
2. Paste the **API key** into the **API Key** field.
3. Enter your **ActiveCampaign account name** — the subdomain from your API URL (for example, `yourcompany`).
4. (Optional) Set the **Region** field. It defaults to `api-us1` — set it only if your API URL ends in a different region (for example, `api-us2` or `api-eu1`).
5. Click **Save**.


Frontegg builds every API request as `https://<accountName>.<region>.com/api/3` and sends your key in the `Api-Token` header.

### Additional resources

- [ActiveCampaign API v3 reference](https://developers.activecampaign.com/reference)
- [Getting started with the ActiveCampaign API](https://help.activecampaign.com/hc/en-us/articles/207317590-Getting-started-with-the-API)