Mailchimp Help & Support

What Mailchimp Triggers and Actions are Supported?

Supported Triggers#

  • New Subscriber - Triggers when a new subscriber is added to an audience.
  • New Unsubscriber - Triggers when any current subscriber unsubscribes from an audience.
  • New Subscriber With Tag - Triggers when a subscriber is added to a Tag within an audience.
  • Updated Subscriber - Triggers when a subscriber is added or updated in an audience.
  • New Audience - Triggers when a new audience is added to your MailChimp accounts.
  • New Campaign - Triggers when a new campaign is created or sent.

Supported Actions#

  • Create Custom Event - Creates a custom event for an existing subscriber.
  • Send Campaign - Sends a campaign draft. PLEASE NOTE: This action sends an email to everyone signed up to the Campaign. Are you trying to send an email to just one person? Set up an Automation within MailChimp and assign the welcome email to a tag. Then assign that tag to your customer with the Add Subscriber To Tag Action.
  • Create Campaign - Creates a campaign draft.
  • Add/Update Subscriber - Add a new subscriber to an audience of your choosing. Can be used to update an existing subscriber too.
  • Add Subscriber to Tag - Add an email address to a tag within an audience. Note: the email address must already be subscribed to the audience, or this will fail.
  • Unsubscribe Email - Unsubscribe an email address from an audience of your choosing.
  • Add Note to Subscriber - Adds a new note to an existing subscriber.

Supported Searches#

  • Find a Campaign - Finds an existing campaign.
  • Find a Subscriber - Searches for a new subscriber on your MailChimp audience.
Was this content helpful?

How to Get Started with Mailchimp

About Mailchimp's Integration#

  • Admin/owner permissions - there are no restrictions on what team member you must be to access Mailchimp's integration features.
  • Paid/versioned account - you can be on any plan to access Mailchimp's integration features.
  • Custom field support - Yes! You can use merge fields in Zaps.

Connecting to 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 content helpful?

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:

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!

My Mailchimp Signup Form Fields Are Not Showing Up#

Click the "Refresh Fields" Button for the other fields to appear

gif showing "refresh fields" button being clicked and fields appearing after

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.

Another instance where your Zap may not trigger as expected is where subscribers are imported into Mailchimp. To work around this, you can use our Import/Export workaround in order to trigger on these subscribers.

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: ""
  • GOOD:

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.

What are the options for "Replace Groups"?#

When using the action "Create/Update Subscriber", there's a setting that lets you specify how groups/interests should be handled if the subscriber already exists in your list.

  • Add Only - any groups/interests specified by your Zap will be added to the subscriber.
  • Replace All - all of the subscriber's existing groups will be cleared, and only the groups selected within your Zap's setup will be added.
  • Replace Matching - clears/replaces only the groups that are specified by your Zap.

For example: if a MailChimp list had these hypothetical groups/interests:

  • Pizza Toppings: cheese, pepperoni, sausage
  • Ice Cream: vanilla, chocolate, mint

Suppose an existing subscriber within the MailChimp list has the following/existing interest groups:

  • Pizza -> cheese
  • Ice Cream -> mint

A Zap is configured to add the group/interest "Ice Cream -> chocolate".

Here's what would happen for the three possible settings for "Replace Groups":

  • Add Only: Results in "Pizza -> cheese", "Ice Cream -> mint", and adds "Ice Cream -> chocolate"
  • Replace All: Clears the subscriber's groups, and results in just "Ice Cream -> chocolate"
  • Replace Matching: Clears the subscribers "Ice Cream" groups, and results in "Pizza -> cheese" and "Ice Cream -> chocolate")

Error: Invalid Resource - Please provide a valid email address#

The reasons why this message appears comes down to a few things:

  • The data inputted isn’t in an email format
  • More than one email address gets put into this field, only put in one email address can be placed
  • Role-based emails such as admin@, info@ or billing@ will be automatically rejected. If you need more information how to add a role based email as a subscriber, more information can be found on MailChimp’s docs here:
Was this content helpful?

Need More Help? - Our support team is happy to help -- send us a message

Share your ideas with Mailchimp email newsletters—then use its landing page and form builders to grow your lists and take marketing further with drip and transactional emails.

Learn More

Getting Started with Zapier

Need more help? Try the Zapier Help Center