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

# Mailchimp Marketing

> Provider ID: `MailchimpMarketing`

## Getting Started

You can connect to the Mailchimp Marketing API using an API key or OAuth2.

### API Key Setup

<Steps>
  <Step title="Generate a Mailchimp API Key">
    In your Mailchimp account, navigate to **Profile > Extras > API keys**. Click **Create A Key**, give it a label (e.g. `Strata Integration`), and copy the generated key.
    See also [this guide from Mailchimp](https://mailchimp.com/developer/marketing/guides/quick-start/#generate-your-api-key)

    <Note>
      The API key includes a server prefix (e.g. `us21`). Strata uses this prefix to route requests to the correct Mailchimp data center.
    </Note>
  </Step>

  <Step title="Configure the Integration in Strata">
    Select Mailchimp Marketing in the [Strata Integration Catalog](https://app.connectstrata.com/integrations). Enter your API key to connect.
  </Step>
</Steps>

### OAuth2 Setup

<Steps>
  <Step title="Register an OAuth2 Application">
    Go to the [Mailchimp OAuth2 registration page](https://admin.mailchimp.com/account/oauth2/) and register a new application. Add the Strata OAuth callback URL as a redirect URI:

    ```text theme={null}
    https://connect.connectstrata.com/oauth/callback
    ```

    Copy the **Client ID** and **Client Secret**.
  </Step>

  <Step title="Configure the Integration in Strata">
    Select Mailchimp Marketing in the [Strata Integration Catalog](https://app.connectstrata.com/integrations). Enter your OAuth client ID, client secret, and required scopes.
  </Step>
</Steps>

## Webhooks

Mailchimp supports webhooks to notify your application of changes to audience data (subscribes, unsubscribes, profile updates, etc.). See the [Mailchimp webhook guide](https://mailchimp.com/developer/marketing/guides/sync-audience-data-webhooks/) for setup instructions.

Mailchimp also supports [programmatic webhook creation via the List Webhooks API](https://mailchimp.com/developer/marketing/api/list-webhooks/add-webhook/), which could enable automatic webhook registration in a future release.