Overview
ActiveCampaign is a marketing-automation + sales CRM platform – email campaigns, automations, contacts, deals, lists, tags. The Automize ActiveCampaign connector covers contacts + campaigns + lists + tags + CRM deals.
- Regions: ActiveCampaign accounts have a unique sub-domain (youraccount.api-us1.com – number can be us1, us2, etc.).
- Plans: Lite, Plus, Professional, Enterprise – all expose the API. Some features (lead-scoring, CRM with sales automation) need Plus+.
Setting up the connection
Auth type: API Key.
- Sign in to ActiveCampaign → Settings → Developer → API Access.
- Copy your API URL + API Key.
- In Automize, open Settings → Connectors → ActiveCampaign → Add connection. Paste both.
Find your credentials at https://help.activecampaign.com/hc/en-us/articles/207317590.
Rate limits
ActiveCampaign enforces 5 req/sec per account. Connector retries 429 with backoff. Bulk operations available via /bulk_create endpoints (not exposed here).
Data model
Marketing + CRM:
Account ─┬─ Contacts ─── Lists (subscriber groups)
│ └─ Tags (labels for segmentation)
├─ Campaigns (email sends)
├─ Automations (multi-step workflows)
└─ Deals (sales pipeline)Available operations
13 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Add Contact to List | General | Add a contact to a list |
| Add Tag to Contact | General | Add a tag to a contact |
| Create Campaign | General | Create a new email campaign |
| Create Contact | General | Create a new contact |
| Create Deal | General | Create a new deal |
| Get Contact | General | Get contact details by ID |
| List Automations | General | List all automations |
| List Campaigns | General | List all email campaigns |
| List Contacts | General | List all contacts |
| List Deals | General | List all deals |
| List Lists | General | List all contact lists |
| List Tags | General | List all tags |
| Update Contact | General | Update an existing contact |
Operations
Add Contact to List
Add a contact to a list
| Parameter | Required | Type | Description |
|---|---|---|---|
Contactlist contactList | Yes | text |
Tips
- contactList: {list, contact, status (1=active)}. Adds the contact to a list as a subscriber.
Add Tag to Contact
Add a tag to a contact
| Parameter | Required | Type | Description |
|---|---|---|---|
Contacttag contactTag | Yes | text |
Tips
- contactTag: {contact, tag (tag_id)}. Add a tag for behavioural targeting.
Create Campaign
Create a new email campaign
| Parameter | Required | Type | Description |
|---|---|---|---|
Campaign campaign | Yes | text |
Tips
- campaign: {name, type, sdate (send date), fromemail, list_id, message_id}.
- Complex setup – usually easier in the UI then trigger sends via API.
Create Contact
Create a new contact
| Parameter | Required | Type | Description |
|---|---|---|---|
Contact contact | Yes | text |
Tips
- contact: {email, firstName, lastName, phone, fieldValues:[{field:1, value:'...'}]}.
- Use Update Contact for upsert behaviour.
Create Deal
Create a new deal
| Parameter | Required | Type | Description |
|---|---|---|---|
Deal deal | Yes | text |
Tips
- deal: {title, value, currency, contact, group (pipeline_id), stage (stage_id), owner}.
Get Contact
Get contact details by ID
| Parameter | Required | Type | Description |
|---|---|---|---|
Contact Id contact_id | Yes | text |
Tips
- Returns contact + fieldValues (custom fields).
List Automations
List all automations
No input parameters.
Tips
- Returns active + paused automations. Trigger entry via Contact-add-to-automation (not currently exposed).
List Campaigns
List all email campaigns
No input parameters.
Tips
- Filter by status (drafted, sent, scheduled).
List Contacts
List all contacts
No input parameters.
Tips
- Page via limit (max 100) + offset. Filter by email, status (1=active, 2=unsubscribed).
List Deals
List all deals
No input parameters.
Tips
- CRM sales pipeline. Filter by stage, pipeline, status.
List Lists
List all contact lists
No input parameters.
Tips
- Returns subscription lists. ActiveCampaign uses list_id for compliance grouping.
List Tags
List all tags
No input parameters.
Tips
- Tags are arbitrary labels for segmentation (different from lists which are subscription groups).
Update Contact
Update an existing contact
| Parameter | Required | Type | Description |
|---|---|---|---|
Contact contact | Yes | text | |
Contact Id contact_id | Yes | text |
Tips
- PUT-style on contact object. Useful for upsert pattern.
FAQ
- Lists vs Tags – which?
- Lists are compliance-bearing – subscribers explicitly opt-in/out. Tags are arbitrary labels for segmentation. Send campaigns to lists; segment via tags.
- Custom fields – how?
- Pass fieldValues:[{field: field_id, value: '...'}] on contact create/update. Discover field_id via List Custom Fields (not currently exposed).
- Why does Get Contact return slim data?
- Default response is slim. Use ?include=fieldValues to fold in custom field values.