Open navigation

Mailchimp: Authentication guide

This guide will walk you through how to authenticate or reauthenticate Mailchimp in Supermetrics for Google Sheets, Data Studio, and Excel, as well as data warehouse destinations like Google Cloud Storage, BigQuery, and the Supermetrics API.

Before you begin

To connect Supermetrics to Mailchimp, you need a Mailchimp user account with an Owner or Admin user role level. See Mailchimp’s documentation for instructions on how to grant access for a user account.

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 pulling data from multiple Mailchimp accounts.

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.

Incompatible fields

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

  • Incompatible fields: IllegalDimensionMetricCombinationException

To fix this error, follow these steps.


Google Sheets Data Studio  Excel Data integrations
Before you can authenticate the data source in Google Sheets, you need to install the Supermetrics add-on.
  1. Open a new Google Sheets file. 
  2. Navigate to ExtensionsSupermetricsLaunch to open the Supermetrics sidebar.
  3. Under Data source, select the data source.
  4. Click Start.
  5. Select an account.
  6. Click Allow.
  7. Under Select campaigns/lists, select your campaign/lists. 
When you're ready, learn how to create your first Supermetrics query with Mailchimp.


  • If you encounter an authentication error such as “authentication failed”, “you need to reauthenticate” or similar, see this guide
  • If you encounter a permission error such as “user permission denied” or similar, follow this guide.

Did you find it helpful? Yes No

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