active-campaign

# ActiveCampaign Access the ActiveCampaign API with managed OAuth authentication. Manage contacts, deals, tags, lists, automations, and email campaigns. ## Quick Start ```bash # List all contacts python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/active-campaign/api/3/contacts') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ``` ## Base URL ``` https://gateway.maton.ai/active-campaign/{native-api-path} ``` Replace `{native-api-path}` with the actual ActiveCampaign API endpoint path. The gateway proxies requests to `{account}.api-us1.com` and automatically injects your OAuth token. ## Authentication All requests require the Maton API key in the Authorization header: ``` Authorization: Bearer $MATON_API_KEY ``` **Environment Variable:** Set your API key as `MATON_API_KEY`: ```bash export MATON_API_KEY="YOUR_API_KEY" ``` ### Getting Your API Key 1. Sign in or create an account at [maton.ai](https://maton.ai) 2. Go to [maton.ai/settings](https://maton.ai/settings) 3. Copy your API key ## Connection Management Manage your ActiveCampaign OAuth connections at `https://ctrl.maton.ai`. ### List Connections ```bash python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections?app=active-campaign&status=ACTIVE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ``` ### Create Connection ```bash python <<'EOF' import urllib.request, os, json data = json.dumps({'app': 'active-campaign'}).encode() req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ``` ### Get Connection ```bash python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ``` **Response:** ```json { "connection": { "connection_id": "9e8ba2aa-25ec-4ba0-8815-3068be304dca", "status": "ACTIVE", "creation_time": "2026-02-09T20:03:16.595823Z", "last_updated_time": "2026-02-09T20:04:09.550767Z", "url": "https://connect.maton.ai/?session_token=...", "app": "active-campaign", "metadata": {} } } ``` Open the returned `url` in a browser to complete OAuth authorization. ### Delete Connection ```bash python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ``` ### Specifying Connection If you have multiple ActiveCampaign connections, specify which one to use with the `Maton-Connection` header: ```bash python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/active-campaign/api/3/contacts') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Maton-Connection', '9e8ba2aa-25ec-4ba0-8815-3068be304dca') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ``` If omitted, the gateway uses the default (oldest) active connection. ## API Reference ### Contacts #### List Contacts ```bash GET /active-campaign/api/3/contacts ``` **Query Parameters:** - `limit` - Number of results (default: 20) - `offset` - Starting index - `search` - Search by email - `filters[email]` - Filter by email - `filters[listid]` - Filter by list ID **Response:** ```json { "contacts": [ { "id": "1", "email": "user@example.com", "firstName": "John", "lastName": "Doe", "phone": "", "cdate": "2026-02-09T14:03:19-06:00", "udate": "2026-02-09T14:03:19-06:00" } ], "meta": { "total": "1" } } ``` #### Get Contact ```bash GET /active-campaign/api/3/contacts/{contactId} ``` Returns contact with related data including lists, tags, deals, and field values. #### Create Contact ```bash POST /active-campaign/api/3/contacts Content-Type: application/json { "contact": { "email": "newcontact@example.com", "firstName": "John", "lastName": "Doe", "phone": "555-1234" } } ``` **Response:** ```json { "contact": { "id": "2", "email": "newcontact@example.com", "firstName": "John", "lastName": "Doe", "cdate": "2026-02-09T17:51:39-06:00", "udate": "2026-02-09T17:51:39-06:00" } } ``` #### Update Contact ```bash PUT /active-campaign/api/3/contacts/{contactId} Content-Type: application/json { "contact": { "firstName": "Updated", "lastName": "Name" } } ``` #### Delete Contact ```bash DELETE /active-campaign/api/3/contacts/{contactId} ``` Returns 200 OK on success. #### Sync Contact (Create or Update) ```bash POST /active-campaign/api/3/contact/sync Content-Type: application/json { "contact": { "email": "user@example.com", "firstName": "Updated Name" } } ``` Creates the contact if it doesn't exist, updates if it does. ### Tags #### List Tags ```bash GET /active-campaign/api/3/tags ``` **Response:** ```json { "tags": [ { "id": "1", "tag": "VIP Customer", "tagType": "contact", "description": "High-value customers", "cdate": "2026-02-09T17:51:39-06:00" } ], "meta": { "total": "1" } } ``` #### Get Tag ```bash GET /active-campaign/api/3/tags/{tagId} ``` #### Create Tag ```bash POST /active-campaign/api/3/tags Content-Type: application/json { "tag": { "tag": "New Tag", "tagType": "contact", "description": "Tag description" } } ``` #### Update Tag ```bash PUT /active-campaign/api/3/tags/{tagId} Content-Type: application/json { "tag": { "tag": "Updated Tag Name" } } ``` #### Delete Tag ```bash DELETE /active-campaign/api/3/tags/{tagId} ``` ### Contact Tags #### Add Tag to Contact ```bash POST /active-campaign/api/3/contactTags Content-Type: application/json { "contactTag": { "contact": "2", "tag": "1" } } ``` #### Remove Tag from Contact ```bash DELETE /active-campaign/api/3/contactTags/{contactTagId} ``` #### Get Contact's Tags ```bash GET /active-campaign/api/3/contacts/{contactId}/contactTags ``` ### Lists #### List All Lists ```bash GET /active-campaign/api/3/lists ``` **Response:** ```json { "lists": [ { "id": "1", "stringid": "master-contact-list", "name": "Master Contact List", "cdate": "2026-02-09T14:03:20-06:00" } ], "meta": { "total": "1" } } ``` #### Get List ```bash GET /active-campaign/api/3/lists/{listId} ``` #### Create List ```bash POST /active-campaign/api/3/lists Content-Type: application/json { "list": { "name": "New List", "stringid": "new-list", "sender_url": "https://example.com", "sender_reminder": "You signed up on our website" } } ``` #### Update List ```bash PUT /active-campaign/api/3/lists/{listId} Content-Type: application/json { "list": { "name": "Updated List Name" } } ``` #### Delete List ```bash DELETE /active-campaign/api/3/lists/{listId} ``` ### Contact Lists #### Subscribe Contact to List ```bash POST /active-campaign/api/3/contactLists Content-Type: application/json { "contactList": { "contact": "2", "list": "1", "status": "1" } } ``` Status values: `1` = subscribed, `2` = unsubscribed ### Deals #### List Deals ```bash