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

# Mailchimp

> Connect Mailchimp to your Atako agents — 17 read and 19 write actions.

Let your agents manage your Mailchimp marketing — audiences, contacts, segments, campaigns, templates and reports.

## Connection

* **Authentication**: API key (API key (xxxx-usNN)).
* **Required settings**:
  * **Datacenter** — Suffix of your API key (e.g. us21 in xxxx-us21)

<Note>
  Mailchimp → click your profile icon → Account & billing → Extras → API keys → Create A Key, name it and copy the generated key (format xxxx-usNN). API keys grant full account access (no scopes to pick). The suffix after the dash (e.g. us21) is your datacenter — enter it in the Datacenter field.

  See [Mailchimp's documentation](https://admin.mailchimp.com/account/api/).
</Note>

## Read actions (17)

| Action                  | Description                                                                             |
| ----------------------- | --------------------------------------------------------------------------------------- |
| `get_audience`          | Fetch details and stats of one audience.                                                |
| `get_automation`        | Fetch one classic automation workflow.                                                  |
| `get_campaign`          | Fetch settings and status of one campaign.                                              |
| `get_campaign_report`   | Fetch the detailed report (opens, clicks, bounces…) of one sent campaign.               |
| `get_member`            | Fetch one audience member by subscriber hash (MD5 of lowercase email) or email address. |
| `get_segment`           | Fetch one segment of an audience.                                                       |
| `get_store`             | Fetch one connected e-commerce store.                                                   |
| `get_template`          | Fetch details of one email template.                                                    |
| `list_audiences`        | List the audiences (lists) in the account.                                              |
| `list_automations`      | List the classic automation workflows in the account.                                   |
| `list_campaign_reports` | List summary reports for sent campaigns.                                                |
| `list_campaigns`        | List campaigns in the account, filterable by status, type or audience.                  |
| `list_members`          | List members of an audience, optionally filtered by status.                             |
| `list_segments`         | List the segments of an audience.                                                       |
| `list_stores`           | List the e-commerce stores connected to the account.                                    |
| `list_templates`        | List the email templates in the account.                                                |
| `search_members`        | Search for members across the account (or one audience) by email or name.               |

## Write actions (19)

| Action                 | Description                                                                                |
| ---------------------- | ------------------------------------------------------------------------------------------ |
| `add_member_tags`      | Add or remove tags on an audience member.                                                  |
| `create_audience`      | Create a new audience (list).                                                              |
| `create_campaign`      | Create a new campaign draft (content is set separately).                                   |
| `create_member`        | Add a new member (contact) to an audience.                                                 |
| `create_segment`       | Create a segment in an audience (static list of emails, or saved segment with conditions). |
| `create_store`         | Connect a new e-commerce store to an audience.                                             |
| `create_template`      | Create a new email template from custom HTML.                                              |
| `delete_audience`      | Permanently delete an audience and all its contacts.                                       |
| `delete_campaign`      | Delete a campaign (drafts only; sent campaigns cannot be deleted).                         |
| `delete_member`        | Archive a member from an audience (removes them from marketing).                           |
| `delete_segment`       | Delete a segment from an audience.                                                         |
| `delete_store`         | Delete a connected e-commerce store.                                                       |
| `delete_template`      | Delete a user-created email template.                                                      |
| `schedule_campaign`    | Schedule a campaign for a future send time (ISO 8601, quarter-hour aligned).               |
| `send_campaign`        | Send a campaign to its recipients immediately.                                             |
| `send_test_email`      | Send a test version of a campaign to given email addresses.                                |
| `set_campaign_content` | Set the HTML or plain-text content of a campaign, or apply a template.                     |
| `update_member`        | Update an existing audience member (status, merge fields, email…).                         |
| `update_segment`       | Update a segment name, static members or conditions.                                       |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.