> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Mailchimp

> Connect Mailchimp from Integrations — API Key, Audience/List ID, Connection Name, auto-send events, test, delivery log, and disconnect.

**Mailchimp** receives Zippendo shipping and order events so you can trigger audience automations. The catalog card copy is: **Send shipping events to Mailchimp to trigger email automations.**

This page is the Mailchimp connect form. Shared chrome: [Connect an integration](/docs/how-to/connect-an-integration). Inventory: [Connect a carrier or integration](/docs/how-to/connect-index). Conditional logic: [Automations](/docs/how-to/automations). Provider essay: [Mailchimp](/docs/integrations/mailchimp).

Creating a connection uses the same plan gate as outbound webhooks (**Growth** and above). Nordlys on this page is **Pro**, so **Connect** is unlocked.

## Prerequisites

* A Mailchimp **API Key**.
* The **Audience/List ID** for the list that should receive events (the ID, not the list display name).

## Where to get the API Key and Audience ID

Generate the key in your Mailchimp account (Manager or Admin). That screen requires signing in. The public help article below is the step we can show.

<Frame caption="Mailchimp help: generate an API key in your own account (the live key screen requires login)">
  <img src="https://mintcdn.com/zippendo/9-sVHrvFOKqRvskN/images/how-to/connect-mailchimp/10-mailchimp-about-api-keys.png?fit=max&auto=format&n=9-sVHrvFOKqRvskN&q=85&s=8add1bfccfe9a96215ef7aee8aaed667" alt="Mailchimp About API Keys help article with a Generate an API key section" width="2880" height="2200" data-path="images/how-to/connect-mailchimp/10-mailchimp-about-api-keys.png" />
</Frame>

## Connect from Catalog

<Steps>
  <Step title="Open Catalog">
    Sidebar **Integrations**. Page title **Integrations**. Description: **Connect downstream tools to receive shipping and order events from Zippendo.** Tabs: **Connected** (`?tab=connected`) and **Catalog** (`?tab=catalog`).
  </Step>

  <Step title="Find Mailchimp">
    Card title **Mailchimp**. Links: **Use in automations** and **Read more** (`https://zippendo.com/docs/integrations/mailchimp`). Button **Connect**, or **Add connection** after the first Mailchimp connection.
  </Step>

  <Step title="Click Connect">
    Modal id `connect-integration-modal`. Title **Connect Mailchimp**. Subtitle: **Send shipping events to Mailchimp to trigger email automations**.
  </Step>

  <Step title="Fill required fields">
    **Connection Name \***, **API Key \***, and **Audience/List ID \***. Tick **Auto-send events** if you want Zippendo to push without an automation.
  </Step>

  <Step title="Connect">
    **Connect** stays disabled until name, API Key, and Audience/List ID are filled. Success toast: **Integration connected successfully**. Failure: **Failed to create connection** (or **This feature is not available on your current plan.**).
  </Step>
</Steps>

<Frame caption="Mailchimp on Catalog — Use in automations, Read more, Connect">
  <img src="https://mintcdn.com/zippendo/pwy1g1EbXWJlGtUC/images/how-to/connect-mailchimp/01-catalog-card-light.png?fit=max&auto=format&n=pwy1g1EbXWJlGtUC&q=85&s=b9ab005a4d935ba2204ca8aa5648687f" alt="Integrations Catalog with the Mailchimp card, Use in automations, Read more, and Connect" className="block dark:hidden" width="2880" height="1800" data-path="images/how-to/connect-mailchimp/01-catalog-card-light.png" />

  <img src="https://mintcdn.com/zippendo/pwy1g1EbXWJlGtUC/images/how-to/connect-mailchimp/01-catalog-card-dark.png?fit=max&auto=format&n=pwy1g1EbXWJlGtUC&q=85&s=88d47cce8ef1bce55dcad58397984107" alt="Integrations Catalog with the Mailchimp card, Use in automations, Read more, and Connect" className="hidden dark:block" width="2880" height="1800" data-path="images/how-to/connect-mailchimp/01-catalog-card-dark.png" />
</Frame>

<Frame caption="Connect Mailchimp — Connection Name, API Key, Audience/List ID, Auto-send events">
  <img src="https://mintcdn.com/zippendo/pwy1g1EbXWJlGtUC/images/how-to/connect-mailchimp/02-connect-modal-light.png?fit=max&auto=format&n=pwy1g1EbXWJlGtUC&q=85&s=8805552a799331ba79394a7ae1a19e30" alt="Connect Mailchimp dialog with Connection Name, API Key, Audience/List ID, and event checkboxes" className="block dark:hidden" width="2880" height="2800" data-path="images/how-to/connect-mailchimp/02-connect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/pwy1g1EbXWJlGtUC/images/how-to/connect-mailchimp/02-connect-modal-dark.png?fit=max&auto=format&n=pwy1g1EbXWJlGtUC&q=85&s=15e9ec277de3b09dec6c47daa0e95a57" alt="Connect Mailchimp dialog with Connection Name, API Key, Audience/List ID, and event checkboxes" className="hidden dark:block" width="2880" height="2800" data-path="images/how-to/connect-mailchimp/02-connect-modal-dark.png" />
</Frame>

## Shared fields

These appear on every integration connect dialog, including Mailchimp.

| Field                  | Required | What it is                                                                                                                                                             |
| ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Connection Name \*** | Yes      | Placeholder **e.g., My Mailchimp**. Max 100 characters.                                                                                                                |
| Hint                   | —        | **Need conditional logic, delays, or multi-step workflows? Create an automation instead.** **Create an automation** links to Automations.                              |
| **Auto-send events**   | No       | Checkbox grid. **Select All** / **Deselect All** toggles every event this provider supports. Empty means Zippendo will not auto-push; **Send test event** still works. |

## Mailchimp credentials

| Field                   | Required | Control                                      | Details                                                                                                                   |
| ----------------------- | -------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **API Key \***          | Yes      | Password. Placeholder **Enter api key**      | Masked. Mailchimp keys include a datacenter suffix (for example `-us21`); Zippendo uses that suffix to pick the API host. |
| **Audience/List ID \*** | Yes      | Text. Placeholder **Enter audience/list id** | The audience ID, not the list name.                                                                                       |

Footer: **Cancel** / **Connect**.

**Event Name Override** exists on the API (`eventConfig`) only. It is **not** a field on Connect or Edit. Override the name from an automation inspector instead — [Automations](/docs/how-to/automations).

## Auto-send events Mailchimp supports

Groups shown: **Shipments**, **Orders**, **Tracking**.

| Checkbox                | Event                 |
| ----------------------- | --------------------- |
| **Shipment Created**    | `shipment.created`    |
| **Shipment Dispatched** | `shipment.dispatched` |
| **Shipment Cancelled**  | `shipment.cancelled`  |
| **Order Created**       | `order.created`       |
| **Order Updated**       | `order.updated`       |
| **Tracking Updated**    | `tracking.updated`    |

Not on this modal: **Shipment Updated**, **Shipment Error**, **Order Cancelled**.

<Frame caption="Mailchimp Auto-send events — Orders and Tracking Updated">
  <img src="https://mintcdn.com/zippendo/9-sVHrvFOKqRvskN/images/how-to/connect-mailchimp/07-events-light.png?fit=max&auto=format&n=9-sVHrvFOKqRvskN&q=85&s=111b79aef845bcbb7e1072f15c2dc7f3" alt="Connect Mailchimp dialog scrolled to Order and Tracking event checkboxes" className="block dark:hidden" width="2880" height="2800" data-path="images/how-to/connect-mailchimp/07-events-light.png" />

  <img src="https://mintcdn.com/zippendo/9-sVHrvFOKqRvskN/images/how-to/connect-mailchimp/07-events-dark.png?fit=max&auto=format&n=9-sVHrvFOKqRvskN&q=85&s=e19a90c77a0c32b69c7e65f5dc6b0b7b" alt="Connect Mailchimp dialog scrolled to Order and Tracking event checkboxes" className="hidden dark:block" width="2880" height="2800" data-path="images/how-to/connect-mailchimp/07-events-dark.png" />
</Frame>

## After you connect

**Connected** shows a green **Connected** pill and **\{\{count}} connection(s)**. Each row: name, **\{\{count}} event(s)** (and **Paused** if inactive — there is **no** pause toggle), **Send test event**, **View delivery log**, **Edit connection**, **Delete connection**.

<Frame caption="Connected — Mailchimp row with test, log, edit, and disconnect">
  <img src="https://mintcdn.com/zippendo/9-sVHrvFOKqRvskN/images/how-to/connect-mailchimp/03-connected-light.png?fit=max&auto=format&n=9-sVHrvFOKqRvskN&q=85&s=9776d2bcebb96d5420419cf31b876667" alt="Integrations Connected tab with a Mailchimp connection and action icons" className="block dark:hidden" width="2880" height="1800" data-path="images/how-to/connect-mailchimp/03-connected-light.png" />

  <img src="https://mintcdn.com/zippendo/pwy1g1EbXWJlGtUC/images/how-to/connect-mailchimp/03-connected-dark.png?fit=max&auto=format&n=pwy1g1EbXWJlGtUC&q=85&s=b1509b8ecc0627cb9ee54e6d52bbd68e" alt="Integrations Connected tab with a Mailchimp connection and action icons" className="hidden dark:block" width="2880" height="1800" data-path="images/how-to/connect-mailchimp/03-connected-dark.png" />
</Frame>

There is **no** Sandbox Mode checkbox. Use **Send test event** (toast **Test event sent** / **Failed to send test event**). Live events need a customer email on the payload so Mailchimp can attach the event to a list member.

## Edit Mailchimp Connection

Modal id `edit-integration-connection-modal`. Title **Edit Mailchimp Connection**. Subtitle **Update the configuration for \{\{connection}}**. **Save Changes** disabled while **Connection Name \*** is empty.

<Frame caption="Edit Mailchimp Connection — API Key, Audience/List ID, Auto-send events">
  <img src="https://mintcdn.com/zippendo/9-sVHrvFOKqRvskN/images/how-to/connect-mailchimp/04-edit-modal-light.png?fit=max&auto=format&n=9-sVHrvFOKqRvskN&q=85&s=71aa08fd700c5effa1c7b85c872710ad" alt="Edit Mailchimp Connection dialog with Connection Name, API Key, Audience/List ID, and Auto-send events" className="block dark:hidden" width="2880" height="1800" data-path="images/how-to/connect-mailchimp/04-edit-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/9-sVHrvFOKqRvskN/images/how-to/connect-mailchimp/04-edit-modal-dark.png?fit=max&auto=format&n=9-sVHrvFOKqRvskN&q=85&s=075482c979354f5c58a8587f48eeeffb" alt="Edit Mailchimp Connection dialog with Connection Name, API Key, Audience/List ID, and Auto-send events" className="hidden dark:block" width="2880" height="1800" data-path="images/how-to/connect-mailchimp/04-edit-modal-dark.png" />
</Frame>

| Field                   | Details                                                                |
| ----------------------- | ---------------------------------------------------------------------- |
| **Connection Name \***  | Same as create.                                                        |
| **API Key \***          | Placeholder **Enter new api key or leave to keep existing**. Password. |
| **Audience/List ID \*** | Placeholder **Enter new audience/list id or leave to keep existing**.  |
| **Auto-send events**    | Same Mailchimp checkboxes as create.                                   |

Toasts: **Integration updated successfully** / **Failed to update connection**.

<Warning>
  Leave every credential blank to keep the stored values. Filling any credential field **replaces** the whole credential set — fill **API Key** and **Audience/List ID** together if you are rotating secrets.
</Warning>

## Delivery log and test

**View delivery log** — modal id `integration-delivery-log-modal`. Title **Delivery Log**. Subtitle **Recent deliveries for \{\{connection}}**. **Close**. Empty: **No deliveries yet**. Rows show event name, HTTP status, duration in `ms`, relative time, and error text.

<Frame caption="Delivery Log — empty until the first auto-send or Send test event">
  <img src="https://mintcdn.com/zippendo/9-sVHrvFOKqRvskN/images/how-to/connect-mailchimp/05-delivery-log-light.png?fit=max&auto=format&n=9-sVHrvFOKqRvskN&q=85&s=5f28cb2d69475433f681eb76c3f117b7" alt="Delivery Log modal showing No deliveries yet for a Mailchimp connection" className="block dark:hidden" width="2880" height="1800" data-path="images/how-to/connect-mailchimp/05-delivery-log-light.png" />

  <img src="https://mintcdn.com/zippendo/9-sVHrvFOKqRvskN/images/how-to/connect-mailchimp/05-delivery-log-dark.png?fit=max&auto=format&n=9-sVHrvFOKqRvskN&q=85&s=592c552a8cff710a8a7c6c3a0689ff01" alt="Delivery Log modal showing No deliveries yet for a Mailchimp connection" className="hidden dark:block" width="2880" height="1800" data-path="images/how-to/connect-mailchimp/05-delivery-log-dark.png" />
</Frame>

**Send test event** enqueues `integration.test`. It does not require any auto-send checkbox.

## Disconnect

Trash opens **Disconnect Integration**. Description: **Are you sure you want to disconnect this integration? This will stop all event deliveries and delete the delivery history.** Type **DELETE** to enable **Disconnect**. Label: **Type DELETE to confirm**.

Toasts: **Integration disconnected** / **Failed to delete connection**. Missing row: **Integration not found.** (`ORG_INTEGRATION_NOT_FOUND`).

<Frame caption="Disconnect Integration — type DELETE to confirm">
  <img src="https://mintcdn.com/zippendo/9-sVHrvFOKqRvskN/images/how-to/connect-mailchimp/06-disconnect-modal-light.png?fit=max&auto=format&n=9-sVHrvFOKqRvskN&q=85&s=6a1fa591a19a1168f8d4baf4e657d3f9" alt="Disconnect Integration confirmation requiring DELETE" className="block dark:hidden" width="2880" height="1800" data-path="images/how-to/connect-mailchimp/06-disconnect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/9-sVHrvFOKqRvskN/images/how-to/connect-mailchimp/06-disconnect-modal-dark.png?fit=max&auto=format&n=9-sVHrvFOKqRvskN&q=85&s=472ac0edc6bc412063bd9252d785065b" alt="Disconnect Integration confirmation requiring DELETE" className="hidden dark:block" width="2880" height="1800" data-path="images/how-to/connect-mailchimp/06-disconnect-modal-dark.png" />
</Frame>

<Check>
  You are done when **Connected** lists Mailchimp with a **Connected** pill and **Send test event** toasts **Test event sent**.
</Check>

## Automations

Palette: **Send Mailchimp Event** — **Sends an event to Mailchimp via a connected integration** (`action.integration.mailchimp`).

| Field                   | Required                         | Details                                                                                                                                                     |
| ----------------------- | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Connection**          | Yes (**Connection is required**) | **Select a connection**. Helper: **Select an existing mailchimp connection. Manage connections in Settings > Integrations.** Empty: **No items available**. |
| **Event name override** | No                               | Placeholder **e.g. Shipment Dispatched**. Helper: **Optional. Override the default event/metric name sent to the provider.**                                |
| **Custom properties**   | No                               | **Add**. Key **key**, value **\{\{shipment.reference}}**.                                                                                                   |

Full node list: [Automations](/docs/how-to/automations).

## Related

* [Connect a carrier or integration](/docs/how-to/connect-index)
* [Connect an integration](/docs/how-to/connect-an-integration)
* [Carrier credentials](/docs/how-to/carrier-credentials)
* [Sandbox mode](/docs/how-to/sandbox-mode)
* [Request a carrier integration](/docs/how-to/request-carrier-integration)
* [Carriers](/docs/tutorials/carriers)
* [Automations](/docs/how-to/automations)
* [Mailchimp](/docs/integrations/mailchimp)
* [Integrations troubleshooting](/docs/integrations/troubleshooting)