# 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
**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

{/* VERIFY: the exact MailChimp → Instasent consent mapping is not yet confirmed. The mapping below applies the consent golden rule; confirm against the connector's actual behaviour before treating it as definitive. */}

Map MailChimp's subscription status to Instasent's marketing-preference attribute
(`_accepts_marketing_*`) following the consent golden rule:

| MailChimp status             | Instasent value | Meaning                     |
| ---------------------------- | --------------- | --------------------------- |
| Subscribed                   | `true`          | Accepted marketing          |
| Never subscribed / no status | `null`          | No preference               |
| Unsubscribed                 | `false`         | Actively declined marketing |

Only an **active opt-out** (unsubscribed) in MailChimp becomes `false`. A contact who
never subscribed maps to **no preference** (`null`), never to `false`. For what these
values mean for who receives a campaign, see
[Consent](/platform/en/consent/marketing-preference-vs-suppression).

---

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.