What Mailchimp Triggers and Actions are Supported?#

Supported Triggers#

  • New Campaign - Triggers when a new campaign is created or sent.
  • New Cleaned Subscriber - Triggers when a new subscriber is cleaned/bounced.
  • New List - Triggers when a new list is created.
  • New Bounce - Triggers when someone bounces from a specific campaign.
  • New Subscriber - Triggers when a new subscriber is added to a list.
  • New Group - A group is for a list.
  • New Unsubscriber - Triggers when any current subscriber unsubscribes from a list.
  • Updated Subscriber - Triggers when a subscriber is added or updated in a list.

Supported Actions#

  • Add/Update Subscriber - Add a new subscriber to a list of your choosing. Can be used to update an existing subscriber too.
  • Unsubscribe Email - Unsubscribe an email address from a list of your choosing.

Supported Searches#

  • Find a Subscriber - Finds an existing subscriber.
  • Find a Campaign - Finds an existing campaign.

How to Get Started with Mailchimp#

When you start creating an MailChimp Zap, you will be prompted to connect a New Account:

Click to connect a new account

You should then get a pop-up window from Mailchimp asking you to log-in to authorize the connection between that Mailchimp account and Zapier.

Log in to authorize your Mailchimp account

After logging in, you'll get sent back to your zap where you now have your Mailchimp account connected!

Your Mailchimp account is authorized

↑ Was this documentation useful? Yes No (Suggest Edits)

Popular Things To Do With Mailchimp#

Common Problems with MailChimp#

I use Google Apps to login to MailChimp, how can I connect my account?#

If you use Google Apps to access your MailChimp account, you'll need to set up a username and password with MailChimp. Here's a link to their guide on doing so: http://kb.mailchimp.com/integrations/other-integrations/integrate-google-apps-with-mailchimp

After you have a username and password, you'll be able to log into your MailChimp account when trying to connect it to Zapier to ensure that connection is made.

Don't Type Emails!#

You'll never want to actually type an actual email address into the forms Zapier gives you. The magic of Zapier is pulling data from the trigger service and putting that data into the forms via our handy variable insertion:


Don't do this!


Do this instead!

Subscribers won't show up in list immediately if you have double opt-in#

If your MailChimp list has double opt-in enabled, you won't see any subscribers added by your zap until after that new subscriber clicks through the double opt-in email. However, your task history will show a successful task immediately, even if the subscriber does not confirm the double opt-in email.

My tasks show a "halted" status#

MailChimp checks for duplication based off email address, so any email addresses your zap is trying to add that already exist in that list will have a "halted" status in your task history. If you want to update the subscriber, you need to change the Updated Existing field to "Yes."


My subscriber isn't triggering the zap#

If someone was subscribed to a list, then unsubscribed, and later was added back to the list, the zap will not trigger as it sees it as a duplicate from the first time they subscribed. Unique email addresses will only be sent once.

Error: "You must specify an apikey value"#

MailChimp sometimes will return an error requesting an API key value when operating on lists. This often is not because MailChimp actually needs an API key, but rather that a different error has occurred. Most frequently, this is due to the email provided to MailChimp containing invalid characters (newlines, quotes, etc.)

  • BAD: "your@email.com"
  • GOOD: your@email.com

Error: "This list does not have interest groups enabled" or "You must specify a apikey value for the listSubscribe method"#

If you are seeing this error it means you don't have interest groups enabled. See this tutorial on how to get enable it.

Error: "ADDRESS must be provided - Please enter a complete address"#

MailChimp requires that you put two spaces between each component of the address field. It should look like this:


Error: Required field "email" (email) is missing#

If the field is mapped, this likely means that the sample record from your trigger data didn't have anything populated in the email field. While the field is mapped correctly, there is no data being sent in the email field, which causes an error.

For example, if you are using the Pipedrive New Person trigger but the person pulled into your trigger sample doesn't have the email filled out, you'll see this in the trigger data:

To fix this, go into Pipedrive and create a brand new person with an email filled in. Back in Zapier, click "Re-test Pipedrive to get another person" and then finish testing the MailChimp action. Same thing would be applicable to a different app and trigger.

How to use custom values for MailChimp Groups#

Given MailChimp's current action template, you are currently required to choose a Group when setting up a New subscriber action.

To get around this, you can use Custom Values. In order for this to properly work, You'll need the Group to match exactly what's in the dropdown from Mailchimp

For example:

So if the Group name is Vanilla, your trigger app can't just provide the word Vanilla as a custom value

You will need to be able to provide Ice Cream flavors->Vanilla as the custom value here

To ensure that you provide MailChimp with the proper data, you can employ a Formatter step here that uses a Lookup Table transform:

The transform app would convert the group name to a properly formatted one. For example, the input here would be Vanilla. The output would be Ice Cream flavors->Vanilla

You can then map out the output of the Formatter step and use that as a custom value for the MailChimp Groups.

Once you are able to pass on data in the proper format, the Zap should proceed properly and dynamically place people on the groups.

Subscribers are being added to the list and they shouldn't be#

Mailchimp has a lot of native integrations, so sometimes you may think something came from Zapier but it really came from a different source. You can validate if a subscriber was added via Zapier by taking a look at the subscriber record in Mailchimp. Subscribers added by Zapier will have a Source of Zapier:

If you see this:

It probably came from a different integration.

↑ Was this documentation useful? Yes No (Suggest Edits)
Get Help