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

# Mailchimp

> 6 production-ready jobs — subscriber personas, campaign content optimization, A/B focus groups, interest-based content generation, re-engagement sequences, and open rate prediction

Mailchimp holds your email marketing intelligence — subscriber demographics, campaign performance, A/B test results, interest tags, and engagement history. These six jobs connect that data to Mavera's surfaces (Custom Personas, Brand Voice, Focus Groups, Generate, Mave Agent) so your personas reflect real subscriber segments, your content matches winning patterns, and your subject lines are tested before you hit send.

***

## API Reference Card

| Detail          | Value                                                           |
| --------------- | --------------------------------------------------------------- |
| **Base URL**    | `https://{dc}.api.mailchimp.com/3.0/`                           |
| **Auth**        | API Key via HTTP Basic (`anystring:API_KEY`) or OAuth 2.0       |
| **Rate limits** | 10 simultaneous connections                                     |
| **Data center** | Extract `dc` from your API key (e.g. `us14` from `abc123-us14`) |
| **Mavera base** | `https://app.mavera.io/api/v1`                                  |
| **Mavera auth** | `Authorization: Bearer mvra_live_...`                           |

<Info>
  All examples use three environment variables: `MAILCHIMP_API_KEY` (your full API key including the `-dc` suffix), `MAILCHIMP_DC` (data center, e.g. `us14`), and `MAVERA_API_KEY`. Python examples use `requests` with Basic Auth (`anystring` as username, API key as password); JavaScript examples use `fetch` with the same pattern.
</Info>

***

## Prerequisites

<Steps>
  <Step title="Mailchimp account with data">You need a Mailchimp account with at least one audience (list) containing subscribers and at least 5 sent campaigns with performance data.</Step>
  <Step title="API key">Generate an API key in Mailchimp → Account & Billing → Extras → API keys. The key includes your data center suffix (e.g. `abc123def456-us14`).</Step>
  <Step title="Extract data center">The `dc` is the portion after the dash in your API key. For `abc123def456-us14`, your DC is `us14` and your base URL is `https://us14.api.mailchimp.com/3.0/`.</Step>
  <Step title="Mavera API key">Get your key from [Mavera dashboard](https://app.mavera.io/settings/api-keys).</Step>

  <Step title="Environment variables">
    ```bash theme={"dark"}
    export MAILCHIMP_API_KEY="abc123def456-us14"
    export MAILCHIMP_DC="us14"
    export MAVERA_API_KEY="mvra_live_xxxxx"
    ```
  </Step>
</Steps>

***

## Jobs

| # | Job                                                                                                  | Mailchimp Data       | Mavera Surface        | Output                                       |
| - | ---------------------------------------------------------------------------------------------------- | -------------------- | --------------------- | -------------------------------------------- |
| 1 | [Subscriber Segment → Persona Creation](/integrations/mailchimp/subscriber-persona-creation)         | Segments + Members   | Custom Personas       | Segment-grounded personas                    |
| 2 | [Campaign Performance → Content Optimization](/integrations/mailchimp/campaign-content-optimization) | Campaign Reports     | Brand Voice           | Winning-content-derived brand voice          |
| 3 | [Email A/B Winner → Focus Group Why](/integrations/mailchimp/ab-focus-group)                         | A/B Test Results     | Focus Groups          | Qualitative A/B explanation                  |
| 4 | [Audience Interest Tags → Content Generation](/integrations/mailchimp/interest-content-generation)   | Interest Categories  | Generate              | Interest-personalized email content          |
| 5 | [Re-Engagement Campaign Builder](/integrations/mailchimp/re-engagement-builder)                      | Inactive Subscribers | Mave Agent + Generate | Multi-step re-engagement sequences           |
| 6 | [Open Rate Prediction](/integrations/mailchimp/open-rate-prediction)                                 | Historical Campaigns | Focus Groups          | Subject line testing with synthetic audience |

***

## Rate Limits & Production Notes

| Mailchimp API    | Limit                             | Strategy                                       |
| ---------------- | --------------------------------- | ---------------------------------------------- |
| All endpoints    | 10 simultaneous connections       | Use sequential requests with 300-500ms delays  |
| Members endpoint | 1,000 per page; max 10 concurrent | Paginate with `offset`; add delays             |
| Campaign reports | Same connection pool              | Cache results; reports don't change after send |

<Warning>
  Mailchimp's **10 simultaneous connections** limit is strict and applies per API key. If you run multiple jobs in parallel, you'll exceed this quickly. Run jobs sequentially or use separate API keys for concurrent workloads.
</Warning>

**Production checklist:**

| Concern             | Recommendation                                                                                                                                                                    |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| API key security    | Mailchimp API keys have full account access. Use OAuth 2.0 for production integrations with scoped permissions.                                                                   |
| Data center routing | Always extract the `dc` from your API key. Using the wrong DC returns 403. Format: `https://{dc}.api.mailchimp.com/3.0`.                                                          |
| Batch operations    | For creating/updating many subscribers, use Mailchimp's [Batch Operations](https://mailchimp.com/developer/marketing/api/batch-operations/) endpoint instead of individual calls. |
| Webhook vs. polling | For real-time campaign events, use Mailchimp webhooks instead of polling the API. Configure in Audience → Settings → Webhooks.                                                    |
| Mavera credits      | Monitor at [Dashboard](https://app.mavera.io/settings/usage). Job 6 (open rate prediction) with 4 personas × 4 questions is credit-intensive.                                     |
| List hygiene        | Job 5 identifies inactive subscribers. After re-engagement attempts, clean unresponsive addresses to maintain deliverability.                                                     |

***

## What's Next

<CardGroup cols={2}>
  <Card title="All Integrations" icon="plug" href="/integrations">
    50+ API integrations with full code
  </Card>

  <Card title="Mailchimp API Docs" icon="envelope" href="https://mailchimp.com/developer/marketing/api/">
    Official Mailchimp Marketing API reference
  </Card>

  <Card title="Personas API" icon="users" href="/api-reference/personas">
    Full reference for POST /api/v1/personas
  </Card>

  <Card title="Focus Groups API" icon="comments" href="/api-reference/focus-groups">
    Full reference for POST /api/v1/focus-groups
  </Card>

  <Card title="Brand Voice API" icon="microphone" href="/api-reference/brand-voices">
    Full reference for POST /api/v1/brand-voices
  </Card>

  <Card title="Generate API" icon="wand-magic-sparkles" href="/api-reference/generations">
    Full reference for POST /api/v1/generations
  </Card>
</CardGroup>