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

# Mailchimp

> Connect BonData to Mailchimp for audiences, campaigns, and email engagement data

Mailchimp is an email marketing and automation platform used to manage audiences, send campaigns, and track engagement. With BonData, you can connect to your Mailchimp account to read, enrich, and sync your marketing data - including audiences, members, and campaign performance - within Agent workflows.

## Mailchimp Authentication Setup

BonData supports connecting to Mailchimp with OAuth or with an API Key. OAuth is the simplest option; an API Key is useful for service accounts and headless setups.

<Tabs>
  <Tab title="OAuth (Recommended)">
    1. In BonData, navigate to **Integrations** and select **Mailchimp**
    2. Click **Connect**
    3. You'll be redirected to Mailchimp to authorize the connection
    4. Sign in and click **Allow** to grant access
    5. You'll be redirected back to BonData once connected
  </Tab>

  <Tab title="API Key">
    ### Step 1: Generate an API Key

    1. Log in to [Mailchimp](https://login.mailchimp.com/)
    2. Click your profile name in the bottom-left, then **Account & billing**
    3. Go to **Extras** → **API keys**
    4. Click **Create A Key** and copy the generated key

    ### Step 2: Note Your Data Center

    Your API key ends in a data center suffix, for example `-us21`. This suffix identifies your Mailchimp server region and is required to build the API endpoint.

    ### Step 3: Enter Credentials in BonData

    1. In BonData, navigate to **Integrations** and select **Mailchimp**
    2. Enter your **API Key** and **Data Center**
    3. Click **Connect**
  </Tab>
</Tabs>

<Tip>
  The data center is the part after the dash in your API key. If your key is `a1b2c3...-us21`, your data center is `us21` and all requests are routed to `https://us21.api.mailchimp.com`.
</Tip>

## Required Fields

| Field       | Description                                                        |
| ----------- | ------------------------------------------------------------------ |
| API Key     | Key generated from Account → Extras → API keys (API Key auth only) |
| Data Center | Region suffix from your API key, e.g. `us21` (API Key auth only)   |

## Available Data

Once connected, BonData can sync the following Mailchimp data:

* **Audiences / Lists** - Your subscriber lists with settings and stats
* **Members / Contacts** - Individual subscribers with status, merge fields, and engagement
* **Campaigns** - Sent, draft, and scheduled email campaigns
* **Reports** - Open rates, click rates, bounces, and other campaign metrics
* **Automations** - Automated customer journeys and their emails
* **Segments** - Saved and static segments within an audience
* **Tags** - Contact tags used for organizing and targeting members