activecampaign – OpenClaw Skill

---

name: activecampaign description: ActiveCampaign CRM integration for lead management, deal tracking, and email automation. Use for syncing demo leads, managing clinic sales pipeline, and triggering follow-up sequences. metadata: {"openclaw":{"emoji":"📧","requires":{"bins":["activecampaign"],"env":["ACTIVECAMPAIGN_URL","ACTIVECAMPAIGN_API_KEY"]},"primaryEnv":["ACTIVECAMPAIGN_URL","ACTIVECAMPAIGN_API_KEY"]}}

ActiveCampaign Skill 📧

ActiveCampaign integration for CRM automation and sales pipeline management.

Purpose

Manage leads, deals, and email automations for sales:

• Contacts: Sync demo attendees, leads, and prospects
• Deals: Track sales pipeline stages
• Tags: Segment leads (demo-requested, nurture, close-ready)
• Automations: Trigger email sequences based on actions
• Custom Fields: Map order, shipping, billing, and subscription data

Setup

1. Credentials

# Create config directory
mkdir -p ~/.config/activecampaign

# Add credentials
echo "https://youraccount.api-us1.com" > ~/.config/activecampaign/url
echo "your-api-key" > ~/.config/activecampaign/api_key

# Or use environment variables
export ACTIVECAMPAIGN_URL="https://youraccount.api-us1.com"
export ACTIVECAMPAIGN_API_KEY="your-api-key"

Get API credentials from ActiveCampaign:

• URL: Settings → Developer → API Access
• API Key: Settings → Developer → API Access

2. Custom Fields Configuration (Optional)

The skill supports custom field mappings for order, shipping, billing, and subscription data.

# Initialize config from sample
activecampaign config init

# Edit with your field IDs
nano ~/.config/activecampaign/fields.json

The config file is gitignored and should not be committed.

Usage

# Contacts
activecampaign contacts list                    # List all contacts
activecampaign contacts create "email@test.com" "First" "Last"
activecampaign contacts sync "email@test.com" "First" "Last"
activecampaign contacts get <id>
activecampaign contacts search "clinic"
activecampaign contacts add-tag <id> <tag_id>
activecampaign contacts remove-tag <id> <tag_id>

# Deals
activecampaign deals list
activecampaign deals create "Clinic Name" <stage_id> <value>
activecampaign deals update <id> stage=<stage_id> value=<value>
activecampaign deals get <id>

# Tags
activecampaign tags list
activecampaign tags create "Demo Requested"

# Automations
activecampaign automations list
activecampaign automations add-contact <contact_id> <automation_id>

# Custom Fields
activecampaign fields list                    # List configured fields
activecampaign fields get order_fields.order_id
activecampaign fields set-field <contact_id> <field_id> <value>

# Lists
activecampaign lists list
activecampaign lists add-contact <list_id> <contact_id>

# Configuration
activecampaign config init                    # Create fields.json from sample
activecampaign config path                    # Show config file path

Custom Fields Configuration

The skill includes a comprehensive field configuration system for:

Category	Fields
Order	Order ID, Number, Date, Total, Tax, Status, Subtotal, Discount, Currency, Payment details
Shipping	Name, Address 1/2, City, State, Postal Code, Country, Method, Cost
Billing	Address 1/2, City, State, Postal Code, Country
Subscription	ID, Status, Plan, Amount, Currency, Interval, Start, Trial End
Additional	Company, Product info, Lead Campaign, Notes, Birthday, etc.

Setting Field Values

# Get field ID from config
activecampaign fields get order_fields.order_id
# Output: 7

# Set field value on contact
activecampaign fields set-field <contact_id> 7 "ORD-12345"

Rate Limits

• 5 requests per second max
• The wrapper handles rate limiting automatically

Related Skills

• shapescale-crm - Attio CRM integration (source of truth)
• shapescale-sales - Sales workflows and qualification
• campaign-orchestrator - Multi-channel follow-up campaigns

ActiveCampaign CLI - Troubleshooting & Notes

Account Limitations

ActiveCampaign trial accounts have limited API access:

Operation	Trial Account	Paid Account
Contact Read	✅ Working	✅ Working
Contact Create/Update	✅ Working	✅ Working
Deal Create	❌ Blocked	✅ Working
Deal List	✅ Working	✅ Working
Pipeline List	❌ Blocked	✅ Working
Tag Add/Create	❌ Blocked	✅ Working
Lists List	❌ Blocked	✅ Working

Workaround: Use deal_stage_list to infer pipeline structure from stage IDs (stages include pipeline field).

Known API Issues

contact_list Returns Empty

contact_list with api_version=3 does not work for listing all contacts.

Fix: The CLI now uses contact_paginator instead.

JSON vs Form-Data

Some endpoints require form-data format, not JSON:

• contact_add - Works with form-data only
• contact_sync - Works with form-data only
• deal_add - Requires form-data with all fields

contact_tag_add Returns "Contact does not exist"

This is an ActiveCampaign API quirk. The contact exists and can be read, but tagging via API may fail on trial accounts.

Pipeline & Deal Group List Blocked

pipeline_list and deal_group_list return "You are not authorized" on trial accounts. Use deal_stage_list to see stages with their pipeline IDs.

Verified Working Endpoints

Contacts

• contact_paginator - List contacts with pagination
• contact_view - Get single contact by ID
• contact_add - Create new contact (form-data)
• contact_sync - Create or update contact (form-data)

Deals

• deal_list - List deals
• deal_view - Get single deal

Stages & Pipelines

• deal_stage_list - List all stages (includes pipeline ID)

Tags

• tags_list - List all tags

CLI Command Format

# Contacts
activecampaign contacts list                    # List all contacts
activecampaign contacts sync "email@test.com" "First" "Last"
activecampaign contacts get <id>

# Deals
activecampaign deals list                       # List deals
activecampaign deals get <id>                   # Get deal details

# Stages
activecampaign stages list                      # List pipeline stages