Mailchimp connector provides a lightweight, easy to use solution that integrates well into your existing AudienceStream configuration. Mailchimp would be a great place to start for those looking to leverage the power of email marketing with a feature packed platform.

This article will describe how to add shoe fans to "Shoes Lovers" Audience List in MailChimp by using MailChimp Connector.

In this article:

Table of Contents Placeholder

MailChimp configuration

Step 1: Sign Up/ log in to service

You may sign up at

Send Better Email | MailChimp

Step 2: Create your Audience list

Once you have logged in or signed up, navigate to the "Audience" icon in the left menu bar of the screen. From there, click the grey "Create Audience" button on the top right of the screen. You may now enter in the details you want to create for your audience.


Step 3: Find or generate the API Key

Locate your account menu at the bottom of the left menu bar. Click the "Account" tab. From there, click onto "Extras" and then onto "API Keys". Click the grey, "Create A Key" under "Your API keys" section to create the key you will need to get your connector to work. Copy the API key generated to your clipboard.


AudienceStream configuration

Step 1: Create and define attributes

If you do not have an attribute to store the user's email address, we will need to configure a Visitor String Attribute to store the user's email address.


Step 2: Create your audience

Here, you'll define the logic for segmenting our visitors.

Create the audience “Shoes Fans”. Then, set up the audience logic so that all visitors with the "Shoes Fans" Badge, and a true "Known User" boolean (created attribute) will be added to the audience.

"Known User" Boolean was created to determine whether or not we know who the user is. If there is an email address associated with user, it is set to true. If no email address is associated, it is set to false. This is a necessary condition due to the fact that one cannot subscribe a user to an email list without having an email address.


Step 3: Configure a new MailChimp Connector in your AudienceStream profile

Configure a new MailChimp Connector. You will need to input the MailChimp API Key we generated earlier in the MailChimp platform.


Step 4: Create and set up the Subscribe Visitor to List action

For this example we simply need to select the audience, target subscriber list and map the "Visitor Email" attribute to "Email Address - Plain".


After we have everything set up, we need to test to make sure it was configured properly. The best way to go about testing is to run a Trace to make sure your events were handled properly and to check your Mailchimp Audience dashboard to make sure the contact is added to the desired Audience list.


Version history
Last update:
‎10-30-2020 01:59 PM
Updated by: