Mailchimp

What It Does

You can manage audiences (lists), subscribers, campaigns, email templates, automations, segments, and pull detailed campaign reports — all from a single `MATON_API_KEY`.

The Mailchimp skill gives your AI agent full access to the Mailchimp Marketing API through Maton's managed OAuth gateway. Instead of handling OAuth flows yourself, you authenticate once via Maton and all requests are proxied with your Mailchimp credentials automatically injected.

Key Features

• Managed OAuth Authentication — Authentication is handled via the Maton gateway — you connect your Mailchimp account once at `ctrl.maton.ai` and all subsequent API calls automatically use your OAuth token. No manual token refresh or OAuth flow implementation required.
• Full Audience & Subscriber Management — Create, update, and delete audiences (lists) and their members. Supports upsert operations, status filtering (`subscribed`, `unsubscribed`, `pending`, `cleaned`), merge fields, tags, and GDPR-compliant permanent deletion.
• Campaign Lifecycle Control — Create campaigns, set HTML or template-based content, check send readiness, schedule for future delivery, send immediately, or cancel scheduled sends. Supports regular, A/B split, RSS, and variate campaign types.
• Segments & Targeting — Create and manage dynamic audience segments using condition-based rules (e.g., email activity within 30 days). Retrieve segment members for targeted campaign recipients.
• Automations Management — List, start, and pause classic Mailchimp automation workflows. Manually enqueue specific subscribers into any step of an automation email series.
• Batch Operations & Pagination — Process multiple API operations in a single batch request — ideal for bulk subscriber imports. All list endpoints support offset-based pagination up to 1,000 records per request.

Requirements

Created by POSTing to `/connections` and completing the browser-based OAuth flow.

- **Maton API Key** *(required)* — Authenticates all requests to the Maton gateway, which proxies calls to Mailchimp with managed OAuth. Obtain at [maton.ai/settings](https://maton.ai/settings). - **Mailchimp OAuth Connection** *(required)* — A Mailchimp account connected via OAuth through `ctrl.maton.ai`.

Use Cases

• Bulk subscriber import from CRM — When a new batch of leads is captured in your CRM, use the batch operations endpoint to add or upsert hundreds of subscribers into a Mailchimp audience in a single API call, complete with merge fields and tags.
• Automated newsletter campaign creation — An AI agent drafts a weekly newsletter, then uses this skill to create a campaign, set the HTML content, schedule it for the next morning, and verify readiness via the send checklist — all without human intervention in Mailchimp.
• Campaign performance reporting — Pull open rates, click rates, and unsubscribe counts across recent campaigns to generate a weekly marketing performance summary or feed data into a business intelligence dashboard.
• Event-triggered automation enrollment — When a user completes a purchase or signs up for a webinar, automatically add them to the relevant Mailchimp automation queue so they receive the appropriate onboarding or follow-up email series.