---
title: Mailchimp incoming webhook setup guide
description: This article describes how to use the Mailchimp data source to create a webhook in your Mailchimp account and send actionable events to Tealium.
url: https://docs.tealium.com/server-side/data-sources/webhooks/setup-guides/mailchimp/
---## 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](https://docs.tealium.com/about-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.

1. Log in to your [Mailchimp account](https://login.mailchimp.com/).
1. Navigate to your **Lists**.
1. Choose the list that you want to configure.
1. Click the **Settings** menu option, then choose **Webhooks**.
1. 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 `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:

* [About Webhooks - Developer Guide - Mailchimp](https://developer.mailchimp.com/documentation/mailchimp/guides/about-webhooks/)

|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"|