> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ActiveCampaign

> Manage contacts, deals, and accounts in ActiveCampaign

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: API key.
* **Connection**: The key from `ACTIVECAMPAIGN_API_KEY` is sent as the `Api-Token` header.
* **Docs**: [https://developers.activecampaign.com/reference/authentication](https://developers.activecampaign.com/reference/authentication)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable                 | Required | Description                                                                                                                                                 |
| ------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ACTIVECAMPAIGN_API_KEY` | Yes      | ActiveCampaign API key (sent as the Api-Token header), from My Settings → Developer [Docs](https://developers.activecampaign.com/reference/authentication). |

## Setup

1. **Find your account subdomain**: Log in to ActiveCampaign and open My Settings → Developer. Your API URL looks like [https://youraccount.api-us1.com](https://youraccount.api-us1.com) - the 'youraccount' part is the value to pass as the 'account' parameter on every tool call. ActiveCampaign offers free developer sandbox accounts via its developer program.
2. **Copy your API key**: On the same Developer page, copy the API Key and add it to your .env as ACTIVECAMPAIGN\_API\_KEY.
3. **Verify access**: Run the List Contacts tool with your account subdomain.

* The API key is sent in the Api-Token header; each user in the account has their own key with that user's permissions
* Every tool requires the 'account' parameter (your API URL subdomain) because the base URL is account-specific (https\://\{account}.api-us1.com)
* Deal values are expressed in cents

Provider API reference: [https://developers.activecampaign.com/reference/overview](https://developers.activecampaign.com/reference/overview)

## Tools

| Tool           | Access | Description                                 |
| -------------- | ------ | ------------------------------------------- |
| List Contacts  | Read   | List or search contacts in ActiveCampaign   |
| Get Contact    | Read   | Get details of an ActiveCampaign contact    |
| Create Contact | Write  | Create a new contact in ActiveCampaign      |
| Update Contact | Write  | Update an existing ActiveCampaign contact   |
| List Deals     | Read   | List deals in ActiveCampaign                |
| Create Deal    | Write  | Create a new deal in ActiveCampaign         |
| List Accounts  | Read   | List accounts (companies) in ActiveCampaign |

## Example prompts

* Search my ActiveCampaign contacts by email and show their details.
* Create a new deal in ActiveCampaign with a title, value, and linked contact.
