Search documentation...



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.


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


To find your api key navigate to

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 cannot be undone, and the user cannot be re-added to the list at a later date.

    Need help?

    Our team is relentlessly focused on your success. We're ready to jump on a call to help unblock you.

    • Connection issues with your data warehouse?
    • Confusing API responses from destination systems?
    • Unsupported destination objects or modes?
    • Help with complex SQL queries?

    Feature Requests?

    If you see something that's missing from our app, let us know and we'll work with you to build it!

    We want to hear your suggestions for new sources, destinations, and other features that would help you activate your data.

On this page

SetupDatacenterAPI KeySyncing Mailchimp ContactsSync ModesRecord MatchingField MappingDelete Mode

Was this page helpful?