Open navigation

Mailchimp connection guide

Follow this guide to connect your Mailchimp account to Supermetrics.

If you need to connect this data source to one of our data warehouse or cloud storage destinations, explore our data warehouse and cloud storage setup guides.

Before you begin

To connect Supermetrics to Mailchimp, you need a Mailchimp user account with either of these user roles: 

  • Owner
  • Admin

Learn how to grant access to a user account in Mailchimp's documentation.

Multi-account login

It's not possible to log into Mailchimp in Supermetrics with multiple accounts. 

If you've authenticated with Mailchimp credentials that have access to multiple Mailchimp accounts, there's a risk that future refreshes will show unpredictable combinations of data from any of the accounts that the original account has access to. Learn more about how to navigate multiple Mailchimp accounts.

Incompatible fields

You might encounter this error when pulling data from Mailchimp in Supermetrics with either Google Sheets or Looker Studio: 

  • Incompatible fields: IllegalDimensionMetricCombinationException

Learn how to fix this error.

Query types

Set up your Mailchimp queries using any of the query types described below.

Reference list: Mailchimp query types
  • Automations: Returns automations. Does not include customer journeys.
  • Automation emails: Returns individual emails in a classic automation workflow.
  • Lists: Returns Mailchimp lists, also known as "audience". 
  • Campaigns: Returns campaigns from your Mailchimp account. 
  • List activity: Returns daily aggregated activity stats for your list. For example, view unsubscribes, signups, total emails sent, opens, clicks, and more, for up to 180 days.
  • List growth history: Returns a summary of the month-by-month growth activity for a specific list.
  • List locations: Returns locations (countries) of subscriber lists. 
  • List members: Returns members of a specific Mailchimp list, including currently subscribed, unsubscribed, and bounced members.


Google Sheets Looker StudioExcel

Make sure you've installed the Supermetrics add-on before you connect.

  1. Open a new Google Sheets file.
  2. Navigate to ExtensionsSupermetricsLaunch sidebar to open Supermetrics.
  3. Click Create new query.
  4. Under Data source, select Mailchimp.
  5. Click Start.
  6. Select an account, and click Allow.
  7. Navigate to Select campaigns/lists to choose the data you'd like to connect.

Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Google Sheets.

More resources

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.