# Mailchimp

> Manage Mailchimp audiences, subscribers, campaigns, automations, templates, and reports.

Lets an agent manage your Mailchimp marketing account - audience lists and subscribers, email campaigns, automations, templates, merge fields, and reports.

## What it can do

| Method | What it does |
| --- | --- |
| `mailchimp_list_lists` | List all audience lists. |
| `mailchimp_get_list` | Get one list by ID. |
| `mailchimp_create_list` | Create a new audience list. |
| `mailchimp_update_list` | Update an existing list. |
| `mailchimp_delete_list` | Delete a list. |
| `mailchimp_list_members` | List members in a list; filter by status. |
| `mailchimp_get_member` | Get one member by email or subscriber hash. |
| `mailchimp_add_member` | Add or subscribe a new member to a list. |
| `mailchimp_update_member` | Update a member's status, merge fields, or interests. |
| `mailchimp_delete_member` | Delete a member from a list. |
| `mailchimp_search_members` | Search members across lists by email, name, or field value. |
| `mailchimp_add_member_tags` | Add or set tags on a member. |
| `mailchimp_remove_member_tags` | Remove tags from a member. |
| `mailchimp_list_campaigns` | List campaigns; filter by status or type. |
| `mailchimp_get_campaign` | Get one campaign by ID. |
| `mailchimp_create_campaign` | Create a new campaign. |
| `mailchimp_update_campaign` | Update a campaign's settings and tracking. |
| `mailchimp_delete_campaign` | Delete a campaign. |
| `mailchimp_set_campaign_content` | Set campaign content via HTML, text, or template. |
| `mailchimp_send_campaign` | Send a campaign. |
| `mailchimp_list_automations` | List automation workflows. |
| `mailchimp_get_automation` | Get one automation workflow by ID. |
| `mailchimp_start_automation` | Start an automation workflow. |
| `mailchimp_list_templates` | List email templates. |
| `mailchimp_get_template` | Get one template by ID. |
| `mailchimp_create_template` | Create an email template from HTML. |
| `mailchimp_update_template` | Update a template's name or HTML. |
| `mailchimp_delete_template` | Delete a template. |
| `mailchimp_list_merge_fields` | List merge (custom) fields for a list. |
| `mailchimp_get_merge_field` | Get one merge field by ID. |
| `mailchimp_create_merge_field` | Create a merge field on a list. |
| `mailchimp_update_merge_field` | Update a merge field. |
| `mailchimp_delete_merge_field` | Delete a merge field. |
| `mailchimp_get_campaign_report` | Get a campaign report - opens, clicks, bounces, etc. |
| `mailchimp_get_list_activity` | Get list activity - subscriptions and unsubscribes. |

## How to get credentials

1. Sign in to your Mailchimp account.
2. Open [admin.mailchimp.com/account/api](https://admin.mailchimp.com/account/api/) (Account -> Extras -> API keys).
3. Click **Create A Key** and give it a name (e.g. *FlyMyAI Agent*).
4. Copy the generated key. The key already includes the datacenter suffix - it looks like `<key>-us21` (or `-eu1`, etc.), and FlyMyAI uses that suffix to reach the right Mailchimp server.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `MAILCHIMP_API_KEY` | Mailchimp -> Account -> Extras -> API keys (server prefix included) |