Mailchimp Integration

Automatically add email signups from your promo code campaigns to your Mailchimp lists.

What You'll Need

• A Mailchimp account (free or paid)
• At least one Mailchimp audience (mailing list)
• A Promo Code Queue account with an active promotion

Step 1: Get Your Mailchimp API Key

1. Log in to your Mailchimp account
2. Click your profile icon in the top right
3. Select "Account & Billing"
4. Navigate to "Extras" → "API keys"
5. Click "Create A Key"
6. Copy the API key (it will look like: abc123def456-us19)

Step 2: Find Your Audience ID

1. In Mailchimp, navigate to "Audience"
2. Click "All contacts" (or select the audience you want to use)
3. Click "Settings" → "Audience name and defaults"
4. Scroll down to find "Audience ID" - it will look like: a1b2c3d4e5
5. Copy this ID

Step 3: Connect Mailchimp in Promo Code Queue

1. Go to your Dashboard → Settings → Integrations
2. Find "Mailchimp" and click "Connect"
3. Enter your Mailchimp API key
4. Click "Test Connection" to verify
5. Select your Audience from the dropdown
6. Click "Save"

Step 4: Enable Mailchimp for Your Promotion

1. Navigate to your promotion in the dashboard
2. Go to "Settings" → "Email Capture"
3. Toggle "Send to Mailchimp" to ON
4. Select which Mailchimp audience to use
5. Optional: Add tags (e.g., "promo-summer-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 Mailchimp audience - the email should appear within 1-2 minutes

Troubleshooting Common Issues

Error: "Invalid API Key"

• Double-check you copied the full API key including the data center suffix (e.g., -us19)
• Make sure the API key hasn't been deleted in Mailchimp
• Try generating a new API key

Error: "Audience not found"

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

Emails not appearing in Mailchimp

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

Duplicate emails being added

• Mailchimp automatically prevents duplicate emails in the same audience
• If you see duplicates, they may be in different audiences
• Check your merge tags to ensure they're updating correctly

Advanced: Using Tags and Segments

Tags help you organize subscribers based on which promotion they signed up from. Use tags to:

• Send targeted emails to users from specific campaigns
• Create segments for future promotions
• Track which campaigns convert best
• A/B test different messaging approaches

Example tags:

• source:summer-giveaway
• product:mobile-app
• campaign:product-hunt-launch

Next Steps