Reading time: 1 minute

MailChimp integration

Mautic can send Contacts to MailChimp based on Contact actions or Point Triggers.

Version notes

  • For Mautic 1.2.3 and later, the authentication is based on the API key.

    This is covered in this document.

  • For Mautic 1.2.2 and older

    • a MailChimp app has to be created
    • the authentication is made via oAuth2
    • Client key and secret credentials are needed for authentication
    • SSL (https) connection is required

This plugin is backward compatible.

  • If the client ID is filled, the plugin will use oAuth2.
  • If the client ID is empty, the plugin will let you insert the API key.


In this document, there may be references to outdated terminology such as

  • leads,
  • lists or lead lists, and
  • anonymous leads

In Mautic version 1.4,

  • leads were renamed to contacts
  • lead lists were renamed to segments
  • anonymous leads were renamed to visitors


Get MailChimp API key

  1. Create a MailChimp account if you don't have one already.
  2. Go to Account / Extras / API Keys and create a new one.
  3. Copy the created API Key.

MailChimp - create a API KeyMailChimp - copy the API Key

Authorize Mautic - MailChimp plugin

Fill in the username you use to log in to MailChimp and the API key. Save the plugin.

Configure the plugin

Navigate to the Features tab in the plugin configuration modal box. You should see this note:

The Contact Field Mapping tab will appear after selecting a segment and will update after changing the selected segment.

MailChimp Plugin configuration

  1. Select the Segment.

    If you don't have a segment in MailChimp created yet, go to MailChimp dashboard / Segments / Create List and create one.

  2. Save the plugin configuration

  3. Open it again.

    The Contact Field Mapping tab should appear now.

  4. Configure the field mapping.

Other configuration options

  • Push contacts to this integration

    This option is checked by default. If you uncheck it, the plugin will not push contacts to MailChimp any more.

  • Enable double opt in - If MailChimp should send a confirmation email to the contacts added by this plugin. The contacts will have to confirm that they really want to be added to the segment.

  • Send welcome email - Whether MailChimp should send the welcome email.

Test the plugin

Follow these steps to test the integration.

Found errors? Think you can improve this documentation? edit this page