ActiveCampaign Integration

Automatically add email signups from your promo code campaigns to your ActiveCampaign lists and trigger powerful automation workflows.

What You'll Need

• An ActiveCampaign account
• At least one ActiveCampaign list
• A Promo Code Queue account with an active promotion

Step 1: Get Your ActiveCampaign API Credentials

1. Log in to your ActiveCampaign account
2. Click "Settings" in the left sidebar
3. Select "Developer"
4. Copy your API URL (e.g., https://youraccountname.api-us1.com)
5. Copy your API Key (it will be a long string of letters and numbers)

Step 2: Find Your List ID

1. In ActiveCampaign, navigate to "Contacts"
2. Click "Lists"
3. Click on the list you want to use
4. The List ID appears in the URL: https://youraccountname.activehosted.com/app/contacts/?listid=1
5. Note this number (e.g., 1)

Step 3: Connect ActiveCampaign in Promo Code Queue

1. Go to your Dashboard → Settings → Integrations
2. Find "ActiveCampaign" and click "Connect"
3. Enter your ActiveCampaign API URL
4. Enter your ActiveCampaign API Key
5. Click "Test Connection" to verify
6. Select your List from the dropdown
7. Click "Save"

Step 4: Enable ActiveCampaign for Your Promotion

1. Navigate to your promotion in the dashboard
2. Go to "Settings" → "Email Capture"
3. Toggle "Send to ActiveCampaign" to ON
4. Select which ActiveCampaign list to use
5. Optional: Add tags (e.g., "promo-2026") to segment subscribers
6. Click "Save Settings"

Step 5: Test the Integration

Before going live, test that emails are being sent correctly:

1. Visit your promotion URL
2. If codes are available, claim them all (or disable the promotion temporarily)
3. Once codes run out, you'll see the email capture form
4. Enter a test email address
5. Check your ActiveCampaign list - the contact should appear within 1-2 minutes

Triggering Automation Workflows

ActiveCampaign's power comes from automation. You can trigger automations when subscribers are added from Promo Code Queue:

Using Tags to Trigger Automations

1. In Promo Code Queue, add a tag like source:promocodequeue or campaign:summer-launch
2. In ActiveCampaign, create a new automation
3. Set the trigger to "Tag is added" and select your tag
4. Build your automation workflow (welcome email, nurture sequence, etc.)

Example Automation Ideas

• Welcome Sequence: Send a series of onboarding emails to new subscribers
• Product Launch Updates: Keep interested users informed about your product
• Re-engagement Campaign: Follow up with users who missed out on codes
• Survey Request: Ask for feedback after a certain period

Troubleshooting Common Issues

Error: "Invalid API URL"

• Make sure you copied the full API URL including the protocol (https://)
• The URL should look like: https://youraccountname.api-us1.com
• Do not include any trailing slashes

Error: "Invalid API Key"

• Double-check you copied the full API key
• Make sure the API key hasn't been deleted in ActiveCampaign
• Try generating a new API key if the problem persists

Error: "List not found"

• Verify you copied the correct List ID
• Make sure the list hasn't been deleted
• Check that your API key has permission to access that list

Contacts not appearing in ActiveCampaign

• Check if the email already exists in your list (ActiveCampaign prevents duplicates)
• Look in "Unsubscribed" contacts
• Verify the integration is enabled for your promotion
• Try disconnecting and reconnecting the integration

Tags not being applied

• Ensure you entered the tag name exactly (case-sensitive)
• Tags are created automatically if they don't exist in ActiveCampaign
• Check the contact record in ActiveCampaign to verify tags

Advanced: Field Mapping

ActiveCampaign supports custom fields for storing additional contact information. You can map data from Promo Code Queue to these fields:

Available Fields to Map

• Promotion Name: Track which campaign the subscriber came from
• Claim Date: When they attempted to get a code
• Code Received: Whether they got a code or not
• Source URL: Where they found your promotion

Setting Up Field Mapping

1. In ActiveCampaign, create custom fields under Settings → Fields
2. In Promo Code Queue, go to Settings → Integrations → ActiveCampaign
3. Click "Configure Field Mapping"
4. Map each Promo Code Queue field to your ActiveCampaign fields
5. Click "Save Mapping"

Best Practices

• Use descriptive tags: Tag subscribers with both the source and campaign name
• Segment your lists: Create separate lists or use tags for different products
• Set up automations: Welcome new subscribers immediately with an automation
• Track conversions: Use ActiveCampaign's site tracking to see who converts
• Clean your list regularly: Remove inactive or bounced contacts

Next Steps