# MailChimp

Connect MailChimp as a data source: authorize with OAuth and pick one list, the contacts and events it syncs, how its fields map to Instasent attributes, and how MailChimp's subscription status maps to consent.

**Language:** en
**Audience:** platform
**TLDR:** Native OAuth connector: you authorize Instasent from MailChimp, no keys to copy. Each list connects separately; it imports that list's contacts and events and keeps them synced from MailChimp into Instasent, and its webhooks can trigger automations.
**Translation key:** platform.data-sources.connectors.mailchimp
**Search keywords:** MailChimp, Mailchimp, list, audience, email marketing, contacts, events, OAuth, connect MailChimp, MailChimp integration, MailChimp consent, subscribed, unsubscribed, cleaned, pending
**Related pages:** /platform/es/data-sources/connectors/mailchimp, /platform/en/data-sources/connectors, /platform/en/data-sources/connectors/klaviyo, /platform/en/data-sources/managing, /platform/en/consent
**Docs index (every page):** https://docs.instasent.com/llms.txt
**This zone's index:** https://docs.instasent.com/platform/en/llms.txt
**This page:** https://docs.instasent.com/platform/en/data-sources/connectors/mailchimp/ (HTML) · https://docs.instasent.com/platform/en/data-sources/connectors/mailchimp.md (Markdown)
**Other language (es):** https://docs.instasent.com/platform/es/data-sources/connectors/mailchimp.md

MailChimp is the native connector for your email-marketing lists. Once authorized, it
imports the contacts of one MailChimp list into Instasent and keeps them synchronized,
so your email audience can drive SMS campaigns and automations alongside the rest of
your audience.

## How to connect

MailChimp is a **[native OAuth connector](/platform/en/data-sources/connectors#native-oauth)**:
you authorize Instasent from MailChimp and, once connected, pick which list to import.
There's no key to create or copy anywhere.

#### 1. Add the data source

In **Data sources**, select **Add data source** and choose **MailChimp** from the
Integrations section.

#### 2. Authorize in MailChimp

Select the connect action to open MailChimp's authorization window, sign in if
needed, and approve the access.

#### 3. Choose the list

Back in Instasent, select the MailChimp list to import to your audience. **Each list
is imported separately** — since lists may have different fields and data, connect
another data source for each list you want.

#### 4. Initial import

The connector imports the contacts of that list, then keeps them in sync.

![The Connect MailChimp setup page with the connector description, the data it syncs and the contact fields it maps](/platform/en/data-sources/images/mailchimp--1-connect.png)
*The MailChimp connector page: what it brings into Instasent and the contact fields it maps, with Connect MailChimp to start.*

## What it syncs

- **Contacts** — the members of the selected list, with their fields.
- **Events** — activity from your MailChimp list, available for segments and
  automations.

MailChimp keeps the data current through **real-time webhooks** and **periodic
resynchronization**, and its webhooks can **trigger your automations** as activity
happens. The direction is one-way, **from MailChimp into Instasent**, and contacts unify
by email and phone — see
[unification](/platform/en/data-sources/managing#how-unification-works).

## Field mapping

MailChimp contact fields map to the matching Instasent attributes — email to `_email`,
phone to `_phone_mobile`, and so on — and events arrive with their parameters. As with
any source you confirm the mapping on setup; see
[field mapping](/platform/en/data-sources/managing#field-mapping).

## Consent mapping

MailChimp is an email platform, so it sets only the **email** marketing preference; it never
changes the SMS preference. Each member's subscription status is imported like this:

| MailChimp status                                                         | Instasent value | Meaning                  |
| ------------------------------------------------------------------------ | --------------- | ------------------------ |
| Subscribed                                                               | `true`          | Accepted email marketing |
| Unsubscribed                                                             | `false`         | Declined email marketing |
| Pending, Cleaned, Non-subscribed (transactional), Archived, or no status | `null`          | No preference            |

Only an **unsubscribe** in MailChimp becomes a decline. A member whose address bounced (cleaned)
or who never confirmed (pending) hasn't refused marketing, so they arrive at **no preference**.
An unsubscribe holds even if another data source records the contact as subscribed to email (see
[When your sources disagree](/platform/en/consent/marketing-preference-vs-suppression#when-your-sources-disagree)), and the general rules every connector follows are in [How connectors import consent](/platform/en/data-sources/connectors#how-connectors-import-consent).

---

This is one page of the Instasent documentation. For the complete machine-readable index of every guide and API reference, fetch https://docs.instasent.com/llms.txt — start there for full context.
