With this end-to-end flow you can extract data from MailChimp and transform it into visualizations in any BI tool of your choice.

The flow, in a nutshell:

  • First, the MailChimp source component will collect data from your account: lists of campaigns, members and lists.

  • Then we prepare five tables (campaign, campaign-event, customer, list, list-member) that can be used to visualize results.

  • The data is then written into a database of your choice.

  • Finally, you will schedule and run the entire flow (i.e., the sequence of all the prepared, above mentioned steps, in the correct order). The survey source component, all data manipulations, and the destination component, will be processed.

Table Description

Name Description
CAMPAIGN the list of campaigns (campaign is any distributed content, that’s created and measured in MailChimp) and metrics
CAMPAIGN-EVENT information about campaign events such as type or created date
CUSTOMER the list of customers and theirs email addresses
LIST the list of lists of contacts
LIST-MEMBER The table provides information on marketing contacts and their rating

How to Use Template

The process is simple. We will guide you through it, and, when needed, ask you to provide your credentials and authorize the destination component.

First decide which data source and which data destination you want to use. Then select the corresponding template from the Templates tab in your Keboola Connection project. When you are done, click + Use Template.

Add New Template

This page contains information about the template. Click + Use Template again.

Add MailChimp to Snowflake

You’ll be asked to write a name for the template instance you are about to create. You can use the template as many times as you want and still keep everything organized.

MailChimp to Snowflake - Template Name

After clicking Next Step, you will see the template builder. Fill in all needed credentials and perform the required OAuth authorizations.

Important: Make sure to follow all the steps very carefully to prevent the newly created flow from failing because of any user authorization problems. If you are struggling with this part, go to the section Authorizing Destinations below.

Follow the steps one by one and authorize at least one data source from the list. Finally, the destination must be authorized as well.

MailChimp to Snowflake

When you are finished, click Save in the top right corner. The template builder will create your new configuration, and when it is done, you will be redirected to the Template Catalogue where you can see the newly created flow.

Click Run Template and start building your visualizations a few minutes later.

MailChimp - Flows

Data Sources

These data sources are available in Public Beta:


Data Destinations

These data destinations are available in Public Beta:

Authorizing Data Sources

To use a selected data source component, you must first authorize the data source.


MailChimp Data Source

Insert your MailChimp API token and data center (the last part of the API key after the dash). Then fill in your account user name.

Authorizing Data Destinations

To create a working flow, you must select at least one data destination.

BigQuery Database

BigQuery Destination

To configure the destination component, you need to set up a Google Service Account and create a new JSON key.

A detailed guide is available here.

Google Sheets

Google Sheets Destination

Authorize your Google account.

Duplicate the sheet into your Google Drive and paste the file ID back to Keboola Connection. It is needed for correct mapping in your duplicated Google sheet.

Snowflake Database Provided by Keboola

If you do not have your own data warehouse, follow the instructions and we will create a database for you:

  1. After clicking Save, the template will be used in your project. You will see a flow.
  2. Go there and click on Snowflake Data Destination to configure it. You will be redirected to the data destination configuration and asked to set up credentials.
  3. Select Keboola Snowflake database.
  4. Then go back to the flow and click Run.

DWH Provided by Keboola DWH Provided by Keboola DWH Provided by Keboola DWH Provided by Keboola

Everything is set up.

Snowflake Database

If you want to use your own Snowflake database, you must provide the host name (account name), user name, password, database name, schema, and a warehouse.

Snowflake Destination

We highly recommend that you create a dedicated user for the destination component in your Snowflake database. Then you must provide the user with access to the Snowflake Warehouse.

Warning: Keep in mind that Snowflake is case sensitive and if identifiers are not quoted, they are converted to upper case. So if you run, for example, a query CREATE SCHEMA john.doe;, you must enter the schema name as DOE in the destination component configuration.

More info here.

Most Common Errors

Before turning to the Keboola support team for help, make sure your error is not a common problem that can be solved without our help.

Click on the text under Configuration in the top left corner. This will redirect you to the Snowflake Database component. Now follow the Snowflake Database provided by Keboola on the page Authorizations/destinations.

Then go to the Flows tab and Run the flow again.

Job - Snowflake