Search documentation...

ChangelogBook a demoSign up


Run better email campaigns on Mailchimp with up-to-date customer data from your data warehouse


To setup the Mailchimp destination, you will need your data center and an active API Key.

To find the data center and API key, navigate to the Mailchimp Dashboard.

Data center

To find the data center, look at the prefix for your admin dashboard URL. In this example, the URL is Your prefix would be us1.

In this example us1 is the data center

API key

To find your API key, navigate to the API Keys section of your Mailchimp account.

Go down to the section Your API Keys, and press the Create A Key button if none exist. Otherwise, you'll see your API key in the table.

Mailchimp has API Keys and Mobile SDK API Keys. The Mobile SDK API Key will not work with this integration. You will need to create a regular API Key.

Syncing Mailchimp contacts

Hightouch supports syncing to the following Mailchimp resources:

  • Audience members

Hightouch requires an existing audience in Mailchimp to sync audience members.

Sync modes

This integration supports Upsert mode.

In the Upsert mode, new users will be inserted into Mailchimp and all attributes will be kept up-to-date within Mailchimp.

Record matching

Records can be matched from your source to your Mailchimp workspace by your Mailchimp Audience Member Email in the Upsert mode.

Field mapping

You can sync columns from your source to Mailchimp's default and custom merge fields. Hightouch automatically detects existing merge fields from your Mailchimp audience.

You can add custom merge fields in your Mailchimp dashboard from the Settings page dropdown and selecting Audience fields and *|MERGE|* tags

Once on the Audience fields page you can drop to the bottom of the page and hit the Add A Field button to create a custom merge field.

Delete mode

You can choose what Hightouch's behavior is when records leave the query result set. The default is doing nothing, but you can also set Hightouch to archive or permanently delete the Mailchimp audience member on record exit.

  • ARCHIVE : Unsubscribe a user from your Mailchimp audience, but do not delete the record. Archived members can be re-added at a later date.
  • DELETE : Permanently remove an audience member and delete their information. This action can't be undone, and the user can't be re-added to the list at a later date.

Ready to get started?

Jump right in or a book a demo. Your first destination is always free.

Book a demoSign upBook a demo

Need help?

Our team is relentlessly focused on your success. Don't hesitate to reach out!

Feature requests?

We'd love to hear your suggestions for integrations and other features.

Last updated: Nov 28, 2022

On this page

SetupData centerAPI keySyncing Mailchimp contactsSync modesRecord matchingField mappingDelete mode

Was this page helpful?