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 protected]" "First" "Last"
activecampaign contacts sync "[email protected]" "First" "Last"
activecampaign contacts get \x3Cid>
activecampaign contacts search "clinic"
activecampaign contacts add-tag \x3Cid> \x3Ctag_id>
activecampaign contacts remove-tag \x3Cid> \x3Ctag_id>

# Deals
activecampaign deals list
activecampaign deals create "Clinic Name" \x3Cstage_id> \x3Cvalue>
activecampaign deals update \x3Cid> stage=\x3Cstage_id> value=\x3Cvalue>
activecampaign deals get \x3Cid>

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

# Automations
activecampaign automations list
activecampaign automations add-contact \x3Ccontact_id> \x3Cautomation_id>

# Custom Fields
activecampaign fields list                    # List configured fields
activecampaign fields get order_fields.order_id
activecampaign fields set-field \x3Ccontact_id> \x3Cfield_id> \x3Cvalue>

# Lists
activecampaign lists list
activecampaign lists add-contact \x3Clist_id> \x3Ccontact_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:

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 \x3Ccontact_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