Mailchimp incoming webhook setup guide
This article describes how to use the Mailchimp data source to create a webhook in your Mailchimp account and send actionable events to Tealium.
Prerequisites
- Mailchimp account
- Tealium AudienceStream account
How it works
Mailchimp offers a webhook API that sends outgoing requests to an endpoint that you specify. These requests inform Tealium AudienceStream about activity in your Mailchimp account. When you add the Mailchimp data source 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
To add the Mailchimp data source to your Tealium Customer Data Hub profile, see Data Sources. After adding and connecting the data source, save and publish your profile.
Mailchimp setup
Once you have your data source endpoint you can proceed to your Mailchimp account to create the webhook.
- Log in to your Mailchimp account.
- Navigate to your Lists.
- Choose the list that you wish to configure.
- Click the Settings menu option, then choose Webhooks.
- 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, Mailchimp will send the the data[merges][EMAIL]
attribute to Tealium and it will be converted to mailchimp_data_merges_email
(all lowercase).
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” |
This page was last updated: February 27, 2023