Manage email marketing audiences, subscribers, campaigns, tags, and templates using Mailchimp
The Mailchimp integration connects your agents to Mailchimp for managing audiences, subscribers, email campaigns, tags, templates, and campaign reports.
You need:
- Mailchimp API Key — Generate one from Account → Extras → API keys in your Mailchimp account.
- Server Prefix — The datacenter prefix from your API key. It's the part after the dash (e.g.,
us6 from a key ending in -us6).
- Open Integrations from the sidebar
- Select Mailchimp from the catalog
- Click Add Integration Config
- Give the config a display name (e.g., "Mailchimp")
- Enter your Server Prefix (e.g.,
us6)
- Enter your API Key (used as a Bearer token)
- Save the config
- Open your agent in Agent Studio. Under Model & capabilities → Tools, click Add tool and add the Mailchimp tools you need
- On a tool's card, choose your config under Set default credentials. It applies to every Mailchimp tool in the agent; click Override on one tool's card to give it a different config
- Tools are referenced as
mailchimp.list_audiences, mailchimp.add_member, etc.
| Tool | Description | Action Type |
|---|
list_audiences | Get all audiences (lists) in the account | ReadOnly |
get_audience | Get information about a specific audience by ID | ReadOnly |
| Tool | Description | Action Type |
|---|
list_members | Get members of a specific audience | ReadOnly |
get_member | Get a specific member by email hash | ReadOnly |
add_member | Add a new subscriber to an audience | Irreversible |
update_member | Update an existing subscriber | Reversible |
add_or_update_member | Add or update a subscriber (upsert) | Reversible |
archive_member | Archive a subscriber from an audience | Irreversible |
search_members | Search members across all audiences | ReadOnly |
| Tool | Description | Action Type |
|---|
list_member_tags | Get all tags assigned to a member | ReadOnly |
update_member_tags | Add or remove tags for a member | Reversible |
| Tool | Description | Action Type |
|---|
list_campaigns | Get all campaigns, with optional status/type filters | ReadOnly |
get_campaign | Get details of a specific campaign | ReadOnly |
create_campaign | Create a new email campaign | Reversible |
set_campaign_content | Set the HTML content of a campaign | Reversible |
send_campaign | Send a campaign immediately | Irreversible |
delete_campaign | Delete a campaign (must be in save status) | Irreversible |
| Tool | Description | Action Type |
|---|
list_templates | Get all email templates | ReadOnly |
| Tool | Description | Action Type |
|---|
get_campaign_report | Get performance report for a sent campaign | ReadOnly |
| Tool | Description | Action Type |
|---|
list_segments | Get all segments for an audience | ReadOnly |