Open navigation

Mailchimp: Authentication and reauthentication guide

This guide will walk you through how to authenticate or reauthenticate Mailchimp with Google Sheets, Google Data Studio, and Microsoft 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:

Here’s an example of sufficient user permissions:

Multi-account login

Users can't log into Mailchimp in Supermetrics with multiple accounts. If you've authenticated with Mailchimp login 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.

Data protection agreement 

If you have any questions about how Supermetrics handles and secures your data, read our policy on data privacy and security.


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. 


Learn how to reauthenticate the data source with Supermetrics in Google Sheets.

Next steps

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.