• 3 Minutes to read
  • Dark


  • Dark

Article summary

MailChimp is an all-in-one marketing platform that enables businesses to manage email marketing campaigns, design and send emails, and track their performance. It also offers additional features such as audience segmentation, automation, and reporting to help businesses build and maintain effective marketing strategies and engage with their audience more effectively.

Refer to our website for the list of metrics and attributes available in Dataddo.

Refer to Mailchimp's official documentation to see all available endpoints from the Mailchimp API.

Authorize Connection to MailChimp

In MailChimp

To authorize your MailChimp account, you will need your username, an API key (= API token), and your DC (data center for your account).

  1. In your MailChimp account, navigate to the API keys page.
  2. Click on Create API Key and name your key.
  3. Click on Generate Key and copy the value.
  4. In the first part of your MailChimp URL, you can find your DC, e.g. us1 is the DC in this URL

In Dataddo

  1. On the Authorizers page, click on Authorize New Service and select MailChimp.
  2. Fill in the following fields:
    1. Username: Your MailChimp username.
    2. API Key: MailChimp API key.
    3. DC: Data center for your account (e.g. us1 from
  3. Rename your authorizer for easier identification and click on Save.

How to Create a Mailchimp Data Source

  1. On the Sources page, click on the Create Source button and select the connector from the list.
  2. Select your dataset and click on Next to continue.

    If you are not sure which dataset you need but know the metrics and attributes, use the Search by Name or Attribute function.

    Fixed-schema connector
  3. From the drop-down menu, select your authorizer.
    Didn't find your authorizer?

    Click on Add new Account at the bottom of the drop-down and follow the on-screen prompts. You can also go to the Authorizers tab and click on Add New Service.

  4. Name your data source and select your metrics and attributes. Keep in mind that metrics and attributes depend on the selected dataset.
  5. Configure your sync frequency or the exact synchronization time under Show advanced settings.

    If you need to load historical data, please refer to the Data Backfilling article.

  6. Preview your data by clicking on the Test Data button in the top right corner. You can adjust the date range for a more specific time frame.
  7. Click on Save and congratulations, your new data source is ready!


Data Preview Unavailable

No data preview when you click on Test Data might be caused by an issue with your source configuration. The most common causes are:

  • Date range: Try a smaller date range. You can load the rest of your data afterward via manual data load.
  • Insufficient permissions: Please make sure your authorized account has at least admin-level permissions.

Authorization Error

When authorizing your service and creating your source, make sure that you the DC (data center) field matches the on in your MailChimp, otherwise you might get the following error INTERNAL_SERVER_ERROR.

You can find the DC in the first part of your MailChimp URL. E.g. If your URL is, then us1 is the name of your DC.

Related Articles

Now that you have successfully created a data source, see how you can connect your data to a dashboarding app or a data storage.

Sending Data to Dashboarding Apps

Sending Data to Data Storages

Other Resources

Was this article helpful?

What's Next