Mailchimp

Get account details including plan type, contact limits, industry, company name, and account timezone. Use this first to verify API access and understand account capabilities.

List all audiences (lists) with subscriber counts, open/click rates, and campaign defaults. Returns audience IDs needed for most other tools. Use this to discover which audiences exist before querying members or segments.

Get detailed information about a single audience including subscriber stats, campaign defaults, and permission reminder text. Use when you need full details about a specific list.

List members (subscribers) in an audience with their email, status, merge fields, tags, and activity stats. Supports filtering by status, tag name, and date. Use for auditing subscriber lists or finding specific contacts.

Search for members across all audiences by email address or name. Returns matching contacts with their list membership and status. Use this to find a specific person without knowing which audience they belong to.

List all segments and saved segments for an audience. Segments are filtered subsets of an audience used for targeted campaigns. Returns segment names, member counts, and filter conditions.

Search tags by name for an audience. Tags are labels applied to subscribers for organization and targeting. Returns matching tag names and IDs.

List all classic automation workflows. Returns workflow names, status (sending/paused/save), trigger settings, emails count, and start/create times. Use this to audit existing drip sequences and understand automation setup.

Get detailed information about a single automation workflow including trigger settings, recipients, status, and tracking options. Use this to understand the full configuration of a drip sequence.

List all emails in an automation workflow in send order. Returns subject lines, delay settings, status (paused/sending), and send stats for each email in the drip sequence. Essential for auditing automation content and timing.

Get detailed information about a single email in an automation workflow including subject, from name, delay settings, send stats, and content type. Use to inspect individual steps in a drip sequence.

List subscribers currently queued to receive a specific automation email. Shows who is waiting to receive this step of the drip sequence and when they were added. Useful for monitoring automation flow.

List subscribers who have been removed from an automation workflow. Shows who was pulled out of the drip sequence and is no longer receiving its emails. Useful for auditing automation exclusions.

List all campaigns with filtering by type, status, and date range. Returns campaign names, subject lines, send times, recipients, and delivery stats. Use to review campaign history or find specific sends.

Get detailed information about a single campaign including settings, recipients, tracking options, delivery status, and social media cards. Use for full context about a specific email send.

Get the HTML and plain-text content of a campaign. Returns the full email body including archive URL. Use to review email content, audit copy, or extract template patterns.

List all email templates. Returns template names, types (user/base/gallery), date created, and thumbnail URL. Use to find reusable templates for new campaigns.

Get detailed information about a single template including name, type, date created/edited, and responsive status. Use to inspect template metadata before using it in a campaign.

Get the default content sections of a template. Returns the editable HTML sections that can be customized when using the template in a campaign. Use to understand what parts of a template are customizable.

List performance reports for all campaigns. Returns open rates, click rates, bounce rates, unsubscribe counts, and revenue data. Use for reviewing email performance trends across campaigns.

Get a detailed performance report for a single campaign including opens, clicks, bounces, forwards, abuse reports, unsubscribes, and e-commerce data. Use for deep analysis of a specific email send.

Get the status of a batch operation. Returns progress (total, finished, errored), completion status, and response body URL when done. Use to poll batch operations started with start_batch.

Get click details for a sent campaign showing which URLs were clicked, click counts, and unique click rates. Use for analyzing link engagement and understanding what content resonates.

Get open details for a sent campaign showing which subscribers opened, when, and how many times. Use for analyzing email engagement and identifying most active subscribers.

Get unsubscribe details for a sent campaign showing who unsubscribed, when, and their unsubscribe reason. Use to identify content or frequency issues causing list churn.

Get email activity for a sent campaign showing individual subscriber actions (opens, clicks, bounces). Provides per-subscriber engagement timeline. Use for detailed recipient-level analysis.

Get the HTML and plain-text content of an automation email. Returns the full email body. Use to review or audit the content of drip sequence emails.

Pause all emails in an automation workflow. No new subscribers will receive emails until the automation is restarted. Subscribers already in the queue will not receive pending emails. Use to temporarily halt a drip sequence.

Start (resume) all emails in a paused automation workflow. Subscribers will begin receiving emails again based on their position in the sequence. Use to reactivate a drip sequence after pausing.

Pause a specific email within an automation workflow. Other emails in the sequence continue sending. Subscribers reaching this step will skip it. Use to disable a single step in a drip sequence.

Start (resume) a specific paused email within an automation workflow. The email will begin sending to subscribers who reach this step. Use to reactivate a single step in a drip sequence.

Update settings for a specific automation email including delay, subject line, from name, and schedule. The automation email must be paused before updating. Use to modify timing or content settings of a drip step.

Set the HTML content of a campaign email. Accepts raw HTML, plain text, or template sections. The campaign must be in 'save' (draft) status. Use to set or update the email body before sending.

Update campaign settings including subject line, from name, reply-to, and tracking options. The campaign must be in 'save' (draft) status. Use to modify campaign metadata before sending.

Create a new campaign (email). Requires campaign type and recipient audience. The campaign is created in draft status — use update_campaign_content to add content and send_campaign or schedule_campaign to deliver it.

Send a test email for a campaign to specified email addresses. Use to preview how the email will look before sending to the full audience. Maximum 5 test emails per campaign.

Schedule a campaign to be sent at a specific time. The campaign must have content set and be in draft status. Use instead of send_campaign when you want to send at a future time.

Send a campaign immediately. The campaign must have content set and be in draft status. This action cannot be undone — the email will be delivered to all recipients. Consider using send_test_email first to preview.

Update an existing email template's name or HTML content. Use to modify reusable templates that campaigns are built from.

Create a new email template with HTML content. Templates are reusable email designs that can be used across multiple campaigns. Use mc:edit regions in HTML to define editable sections.

Add a new subscriber to an audience. Set status to 'subscribed' for immediate subscription or 'pending' to send a confirmation email. Returns the new member record with subscriber hash.

Update an existing subscriber's information including status, merge fields, and tags. Accepts either email address or subscriber_hash (MD5 of lowercase email). Use to modify subscriber data or change subscription status.

Add a new subscriber or update an existing one (upsert). If the email exists, updates their info; if not, creates a new subscriber. Use this when you don't know if the contact already exists. Safer than add_member which errors on duplicates.

Add or remove tags from a subscriber. Tags are labels for organizing and segmenting contacts. Accepts either email address or subscriber_hash. Each tag can be set to 'active' (add) or 'inactive' (remove).

Add a subscriber to a static segment (tag-based segment). The member must already exist in the audience. Use to manually add contacts to segments for targeted campaigns.

Start a batch operation to perform multiple API calls in one request. Each operation specifies a method, path, and optional body. Use for bulk updates like updating many subscribers at once. Returns a batch ID to check status.

Trigger a specific step in a Customer Journey for a contact. Customer Journeys are the newer automation builder in Mailchimp (separate from classic automations). Use to manually push a contact into a journey at a specific point.

Export all members of an audience via a batch operation. Creates a batch job that fetches all member data. Returns a batch ID — use get_batch_status to poll for completion and retrieve the results URL.

Archive (soft-delete) a subscriber from an audience. The contact is removed from the active list but their data is retained. They can be re-imported later. Accepts either email address or subscriber_hash.