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

# Mailchimp

> Manage audiences, members, and campaigns in Mailchimp Marketing

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: OAuth 2.0.
* **Connection**: A user authorizes the connection in the provider's consent screen.
* **Docs**: [https://mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/](https://mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.

| Variable                  | Required | Description                                                                                                                              |
| ------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `MAILCHIMP_CLIENT_ID`     | Yes      | Mailchimp OAuth Client ID (from your registered app) [Docs](https://mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/). |
| `MAILCHIMP_CLIENT_SECRET` | Yes      | Mailchimp OAuth Client Secret [Docs](https://mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/).                        |

## Setup

1. **Register a Mailchimp app**: Sign in to Mailchimp (the free plan works for testing) and go to Account → Extras → Registered apps ([https://admin.mailchimp.com/account/oauth2/](https://admin.mailchimp.com/account/oauth2/)). Click Register An App.
2. **Set the redirect URI**: Set the app's Redirect URI to your app URL ending in /api/auth/mailchimp/callback.
3. **Copy credentials**: Copy the Client ID and Client Secret into MAILCHIMP\_CLIENT\_ID and MAILCHIMP\_CLIENT\_SECRET.
4. **Find your data center and verify**: Note the usXX prefix in your Mailchimp admin URL (e.g. us21.admin.mailchimp.com → us21). Connect your account and run List Audiences with that dc value.

* Mailchimp access tokens do not expire and no refresh tokens are issued; reauthorize to rotate
* The OAuth flow uses no scopes; the token grants the user's account access
* The API host is data-center-specific (usXX.api.mailchimp.com). The dc is NOT in the token response - Mailchimp returns it from GET [https://login.mailchimp.com/oauth2/metadata](https://login.mailchimp.com/oauth2/metadata). Tools therefore take dc as a required parameter (the usXX prefix in your admin URL); the tradeoff is the agent must supply it on every call

Provider API reference: [https://mailchimp.com/developer/marketing/api/](https://mailchimp.com/developer/marketing/api/)

## Tools

| Tool           | Access | Description                                                                             |
| -------------- | ------ | --------------------------------------------------------------------------------------- |
| List Audiences | Read   | List audiences (lists) in the Mailchimp account                                         |
| List Members   | Read   | List members of a Mailchimp audience                                                    |
| Get Member     | Read   | Get a single audience member by email (MD5 hash of the lowercase address) or contact ID |
| Add Member     | Write  | Add a new member to a Mailchimp audience                                                |
| List Campaigns | Read   | List campaigns in the Mailchimp account                                                 |

## Example prompts

* List my Mailchimp audiences with their member counts and recent growth.
* Add a new subscriber to one of my Mailchimp audiences with their name and email.