Back

This article describes how to use the MailChimp data source to create a webhook in your MailChimp account to send actionable events into EventStream.

In this article:

Table of Contents Placeholder

Prerequisites

  • MailChimp account
  • EventStream/AudienceStream account

How It Works

MailChimp offers a webhook API that sends outgoing requests to an endpoint that you specify. These requests act like push notifications to EventStream to inform it about things that happened in your MailChimp account. When you add the MailChimp data source in the UDH, a unique endpoint will be generated that you will use to configure the MailChimp webhook.

MailChimp Data Source

The MailChimp data source generates a unique URL to use as the HTTP POST URL in your MailChimp configuration. The generated URL is in the format of:

 https://collect.tealiumiq.com/integration/event/ACCOUNT/PROFILE/DATA_SOURCE_KEY

Add the MailChimp data source before proceeding. (Learn how to add a data source)

MailChimp Setup

Once you have your data source endpoint you can proceed to your MailChimp account to create the webhook.

  1. Log in to your MailChimp account.
  2. Navigate to your Lists.
  3. Choose the list that you wish to configure.
  4. Click the Settings menu option, then choose Webhooks.
  5. Click Create New Webhook and paste your data source endpoint.

Events and Attributes

All incoming MailChimp event attributes are automatically prefixed and underscored with mailchimp_. For example, when the MailChimp webhook sends  data[merges][EMAIL] , the matching EventStream event attribute is  mailchimp_data_merges_email.

See the full list of webhook events and attributes generated by MailChimp:

Event Attribute Type Example
mailchimp_data_action String "unsub"
mailchimp_data_campaign_id String "4fjk2ma9xd"
mailchimp_data_email String "api@mailchimp.com"
mailchimp_data_email_type String "html"
mailchimp_data_id String "8a25ff1d98"
mailchimp_data_ip_opt String "10.20.10.30"
mailchimp_data_ip_signup String "10.20.10.30"
mailchimp_data_list_id String "a6b5da1054"
mailchimp_data_merges_email String "api@mailchimp.com"
mailchimp_data_merges_fname String "MailChimp"
mailchimp_data_merges_interests Array "Group1,Group2"
mailchimp_data_merges_lname String "API"
mailchimp_data_new_email String "api+new@mailchimp.com"
mailchimp_data_new_id String "51da8c3259"
mailchimp_data_old_email String "api+old@mailchimp.com"
mailchimp_data_reason String "Some reason"
mailchimp_data_status String "sent"
mailchimp_data_subject String "Test Campaign Subject"
mailchimp_fired_at String "2009-03-26 21:40:57"
mailchimp_type String "subscribe", "unsubscribe", "upemail", "profile", "cleaned", or "campaign"