Skip to main content
The activecampaign MCP adapter wraps ActiveCampaign API v3. Use it to sync contacts, manage list subscriptions, and update CRM records from agent workflows.

​
Prerequisites

  • An ActiveCampaign account with API access
  • API URL and token from Settings → Developer → API in ActiveCampaign
  • project_contributor access

​
Connect in AgentRuntime

1

Get API credentials

In ActiveCampaign, go to Settings → Developer → API. Copy your API URL (e.g. https://youraccount.api-us1.com) and API token.
2

Create a connection

Go to Connections, click New custom connection, and select ActiveCampaign (or generic API key), and paste your API URL and token.
3

Add activecampaign MCP instance

Go to MCP, click Add instance for activecampaign, wire your connection on Instance config, and set the profile active.
4

Verify with get_users_me

Run a test workflow with an mcp_call to activecampaign_get_users_me to confirm authentication.

​
What you can build

  • Lead capture — Form webhook → activecampaign_create_contact → subscribe to nurture list.
  • Tag-based routing — activecampaign_add_tag_to_contact after LLM scores lead intent from chat transcript.
  • Account sync — activecampaign_create_account + activecampaign_add_contact_to_account when a deal closes in your CRM sheet.
  • Health check — Scheduled activecampaign_get_users_me + activecampaign_list_contacts count for monitoring dashboards.

​
Tools

ToolDescription
activecampaign_get_users_meValidate API credentials
activecampaign_create_contactCreate a new contact
activecampaign_update_contactUpdate an existing contact
activecampaign_list_contactsList contacts with filters
activecampaign_subscribe_or_unsubscribe_contact_from_listAdd or remove a contact from a list
activecampaign_add_tag_to_contactTag a contact
activecampaign_add_contact_to_accountLink a contact to an account
activecampaign_create_accountCreate an account
activecampaign_update_accountUpdate an account

​
Custom fields

Pass custom contact fields as a JSON array in field_values_json: 
[
  {"field": "1", "value": "Enterprise"},
  {"field": "2", "value": "2026-06-01"}
]
Account custom fields use fields_json: 
[
  {"customFieldId": 1, "fieldValue": "West region"}
]

​
Example

Sync a new lead from a form submission: 
{
  "id": "create-lead",
  "type": "mcp_call",
  "name": "Create ActiveCampaign contact",
  "tool_name": "activecampaign_create_contact",
  "tool_args": {
    "email": "{{input.email}}",
    "first_name": "{{input.first_name}}",
    "last_name": "{{input.last_name}}",
    "field_values_json": "[{\"field\":\"1\",\"value\":\"{{input.source}}\"}]"
  },
  "timeout_s": 30
}
Follow with activecampaign_subscribe_or_unsubscribe_contact_from_list to add the contact to a marketing list.

​
Configuration

KeyRequiredDescription
activecampaign_api_urlYesBase URL without trailing slash
activecampaign_api_tokenYesAPI token from Developer settings
activecampaign_http_timeout_secondNoHTTP timeout (default 45s)

​
Troubleshooting

IssueFix
401 UnauthorizedRegenerate API token; update connection
Wrong API regionUse the exact URL from your ActiveCampaign account (api-us1, api-eu1, etc.)
Custom field errorsConfirm field IDs match your account’s custom field definitions