Mailchimp
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 your agent in Agent Studio
- In the Integrations panel, click Add Integration Config
- Select Mailchimp from the integration list
- 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 agent revision
- In an Agent Step, attach Mailchimp tools from the tools panel
- 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 |
