What Mailchimp Triggers and Actions are Supported?#

Supported Triggers#

  • New Subscriber - Triggers when a new subscriber is added to a list.
  • New Subscriber in Segment - Triggers when a subscriber is added to a Segment within 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.
  • New List - Triggers when a new list is added to your MailChimp accounts.
  • New Campaign - Triggers when a new campaign is created or sent.

Supported Actions#

  • Create Campaign - Creates a campaign draft.
  • Send Campaign - Sends a campaign draft.
  • Unsubscribe Email - Unsubscribe an email address from a list of your choosing.
  • Add/Update Subscriber - Add a new subscriber to a list of your choosing. Can be used to update an existing subscriber too.
  • Add Subscriber to Segment - Add an email address to a static segment within a list. Note: the email address must already be subscribed to the list, or this will fail.

Supported Searches#

  • Find a Campaign - Finds an existing campaign.
  • Find a Subscriber - Searches for a new subscriber on your MailChimp list.

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 Email Addresses!#

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 application 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 create and send a campaign#

It takes two Zapier action steps to accomplish this. First, add a Create Campaign action step to your Zap and follow the instructions to set it up. Then, add a Send Campaign action step to your Zap. For the "Campaign" field in this step, select "Use a Custom Value" and then pass in the ID that was returned from the Create Campaign step.

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