---
title: "Connect Mailchimp"
description: "Log in to Mailchimp from Scratcher and add new sign-ups to an audience with the merge fields you choose."
url: https://scratcher.io/help/integrations/mailchimp
language: en
---

1. [Help center](https://scratcher.io/help)
2. [Integrations](https://scratcher.io/help/integrations)
3. Connect Mailchimp

# Connect Mailchimp

Log in to Mailchimp from Scratcher and add new sign-ups to an audience with the merge fields you choose.

With the Mailchimp integration, everyone who signs up is added to a Mailchimp audience. If they are already in the audience, their merge fields are updated.

## What you need

- A Mailchimp account with at least one audience. All Mailchimp plans work, including the free plan.
- A Mailchimp login with admin access to the account, so Scratcher can see all your audiences.

You don't need an API key. You log in to Mailchimp and allow the access.

## Step 1: Connect Mailchimp

1. In Scratcher, go to **Settings** > **Integrations** and click **MailChimp**.
2. Click **Install integration**. You are sent to Mailchimp.
3. Log in to Mailchimp and click **Allow** to let Scratcher connect.
4. You come back to Scratcher, and Mailchimp is installed.

Mailchimp gives Scratcher access to your account through its own login, so there are no permissions to choose. Scratcher only reads your audiences and merge fields and adds or updates members.

## Step 2: Turn it on in a campaign

1. In the editor, go to **Connect** > **Integrations** > **MailChimp** and click **Activate**.
2. If you have connected more than one Mailchimp account, choose it under **Select account**.
3. Under **External list**, choose the audience.
4. Under **Field mappings**, match your fields to the audience's merge fields. For example "Lead - First name" to **First Name** (FNAME) and "Lead - Last name" to **Last Name** (LNAME).
5. Under **Filter by permissions (optional)**, choose your marketing consent checkbox.
6. Click **Save**, and then **Test**.

## Field mapping

- The email address is always sent. Everything else must be mapped.
- The **Destination field** list shows the merge fields of the audience you chose. Create the merge field in Mailchimp first (in the audience, under **Settings** > **Audience fields and merge tags**) if it is missing, and open the integration again.
- If a merge field is required in Mailchimp, you must map it, or Mailchimp rejects the sign-up.
- For a phone merge field, use the **Format** setting to send the number the way Mailchimp expects.

## Consent

New people are added to the audience as **Subscribed**. People who are already in the audience keep their status, so someone who unsubscribed earlier is not subscribed again.

Because new people are subscribed right away, only send people who gave consent: choose your marketing checkbox under **Filter by permissions (optional)**. If you use double opt-in in Scratcher, people have confirmed their address before they are sent. See [Set up double opt-in](https://scratcher.io/help/forms/double-opt-in).

## What is sent and when

New sign-ups are sent within a minute or two. When you activate the integration, the campaign's existing leads are sent too. When someone takes part again, their merge fields are updated.

## Troubleshooting

Failed deliveries show under **Settings** > **Integrations** > **Delivery status** with Mailchimp's own message, for example:

- "Invalid Resource": a value doesn't fit the merge field, or a required merge field is missing. Check the mappings.
- "Member In Compliance State" or "Forgotten Email Not Subscribed": the person unsubscribed or asked to be deleted in Mailchimp. Mailchimp doesn't allow adding them again through an integration.
- The audience list is empty: the Mailchimp login you used can't see the audience. Connect again with an admin login.

Integrations

- [How integrations work](https://scratcher.io/help/integrations/how-integrations-work)
- [All integrations](https://scratcher.io/help/integrations/other-integrations)
- [Check the delivery status and resend leads](https://scratcher.io/help/integrations/delivery-status)
- [Connect HubSpot](https://scratcher.io/help/integrations/hubspot)
- [Connect Salesforce Marketing Cloud](https://scratcher.io/help/integrations/salesforce-marketing-cloud)
- [Connect Microsoft Dynamics 365 with Zapier](https://scratcher.io/help/integrations/microsoft-dynamics-365)
- [Connect Emarsys](https://scratcher.io/help/integrations/emarsys)
- [Connect Klaviyo](https://scratcher.io/help/integrations/klaviyo)
- [Connect Mailchimp](https://scratcher.io/help/integrations/mailchimp)
- [Connect ActiveCampaign](https://scratcher.io/help/integrations/activecampaign)
- [Connect Apsis One](https://scratcher.io/help/integrations/apsis-one)
- [Connect Drip](https://scratcher.io/help/integrations/drip)
- [Connect HeyLoyalty](https://scratcher.io/help/integrations/heyloyalty)
- [Connect Peytz](https://scratcher.io/help/integrations/peytz)
- [Connect Marketingplatform](https://scratcher.io/help/integrations/marketingplatform)
- [Connect Campaign Monitor with Zapier](https://scratcher.io/help/integrations/campaign-monitor)
- [Connect ActiveTrail with Zapier](https://scratcher.io/help/integrations/activetrail)
- [Connect Bloomreach](https://scratcher.io/help/integrations/bloomreach)
- [Connect Iterable](https://scratcher.io/help/integrations/iterable)
- [Connect Mapp](https://scratcher.io/help/integrations/mapp)
- [Connect Agillic](https://scratcher.io/help/integrations/agillic)
- [Connect Ortto](https://scratcher.io/help/integrations/ortto)
- [Connect Emarketeer](https://scratcher.io/help/integrations/emarketeer)
- [Connect Shopify](https://scratcher.io/help/integrations/shopify)
- [Connect Hello Retail](https://scratcher.io/help/integrations/hello-retail)
- [Connect 8,000+ apps with Zapier](https://scratcher.io/help/integrations/zapier)
- [Connect monday.com with Zapier](https://scratcher.io/help/integrations/monday-com)
- [Connect Asana with Zapier](https://scratcher.io/help/integrations/asana)
- [Connect Podio with Zapier](https://scratcher.io/help/integrations/podio)
- [Connect Intercom with Zapier](https://scratcher.io/help/integrations/intercom)

## Related articles

- [How integrations work](https://scratcher.io/help/integrations/how-integrations-work): Connect your email tool or CRM once, turn it on in each campaign, choose a list, map your fields and send only people who gave consent.
- [Check the delivery status and resend leads](https://scratcher.io/help/integrations/delivery-status): See which leads were sent to your tools, understand the error messages, fix the problem and send them again.
- [Ask for consent and add terms and conditions](https://scratcher.io/help/forms/consent-and-permissions): Add consent checkboxes for newsletters, link your terms, choose which checkbox subscribes people and send only people who said yes to your email tool.

## Still need help?

Real people are here to help. If you already use Scratcher, the quickest way is the chat inside the platform.

- **[Chat with us](https://platform.scratcher.io/login)**

    Log in and click the chat button in the bottom-right corner. Rex answers right away, and our team is a click away.
- **[Book a meeting](https://scratcher.io/book-a-meeting)**

    A free 30-minute video call with our team: a tour, campaign ideas or help with your setup.
- **[Email us](mailto:contact@scratcher.io)**

    Write to contact@scratcher.io and we will get back to you.
