Skip to content

Email

Mailchimp
API integration

Ship Email features without building the integration. Full Mailchimp API access via Proxy, normalized data through Unified APIs, and 290+ MCP-ready tools for AI agents — all extensible to your exact use case.

Talk to us
Mailchimp

Use Cases

Why integrate with Mailchimp

Common scenarios for SaaS companies building Mailchimp integrations for their customers.

01

Sync event attendees into Mailchimp for automated follow-up

Event management platforms can push attendee data into their customers' Mailchimp audiences with relevant tags, enabling organizers to trigger pre-event logistics emails and post-event nurture sequences without manual CSV imports.

02

Route form and survey submissions directly to Mailchimp lists

Form builder SaaS products can let users map form fields to Mailchimp merge fields and automatically create contacts on submission, turning every lead-gen form into a live pipeline to their customers' email marketing.

03

Tag contacts based on in-app behavior to trigger Mailchimp automations

Any SaaS product tracking user activity can apply or remove Mailchimp tags in real time — like 'Upgraded to Pro' or 'Churned' — so their customers can build Customer Journeys triggered by product events without writing a single email rule.

04

Push CRM deal-stage changes into Mailchimp for lead nurturing

CRM and sales tools can sync lost or stalled deals into Mailchimp with appropriate tags and custom field data, letting marketing teams automatically run drip campaigns to warm leads back up.

05

Keep subscription lifecycle events reflected in Mailchimp audiences

Billing and subscription platforms can upsert contacts and tag them based on subscription events — trial started, plan upgraded, payment failed, cancelled — so their users can automate lifecycle emails from Mailchimp.

What You Can Build

Ship these features with Truto + Mailchimp

Concrete product features your team can ship faster by leveraging Truto’s Mailchimp integration instead of building from scratch.

01

Mailchimp audience picker and field mapping UI

Let your users select a destination Mailchimp list and dynamically map your app's data fields to Mailchimp merge fields in a clean, in-app configuration flow.

02

Real-time contact upsert on key events

Automatically create or update Mailchimp contacts whenever a relevant event fires in your product — new signup, form submission, deal stage change — using Mailchimp's upsert-friendly API pattern.

03

Behavioral tagging engine for marketing automation

Apply and remove Mailchimp tags based on user actions inside your app, giving your customers a zero-code bridge between product behavior and email automation triggers.

04

Bulk contact sync with tag and merge field enrichment

Ship a one-click sync that pushes your app's contact list into Mailchimp with all associated custom data and tags intact, eliminating manual exports.

05

Subscriber status management dashboard

Surface Mailchimp subscription statuses — subscribed, unsubscribed, cleaned — directly in your product so users can see which contacts are reachable without switching tabs.

SuperAI

Mailchimp AI agent tools

Comprehensive AI agent toolset with fine-grained control. Integrates with MCP clients like Cursor and Claude, or frameworks like LangChain.

list_all_mailchimp_campaigns

List all Mailchimp campaigns in an account. Returns: id, web_id, parent_campaign_id, type, create_time, archive_url, long_archive_url, status, emails_sent, send_time, content_type, needs_block_refresh, resendable, recipients, settings, variate_settings, tracking, rss_opts, ab_split_opts, social_card, report_summary, delivery_status, resend_shortcut_eligibility, resend_shortcut_usage, _links,…

get_single_mailchimp_campaign_by_id

Get information about a specific Mailchimp campaign by id. Returns: id, web_id, parent_campaign_id, type, create_time, archive_url, long_archive_url, status, emails_sent, send_time, content_type, needs_block_refresh, resendable, recipients, settings, variate_settings, tracking, rss_opts, ab_split_opts, social_card, report_summary, delivery_status, resend_shortcut_eligibility,…

create_a_mailchimp_campaign

Create a new Mailchimp campaign. Returns the created campaign including id, type, status, create_time, recipients, and settings. Required: type. A/B Split campaigns have been deprecated; use variate instead.

update_a_mailchimp_campaign_by_id

Update some or all settings for a specific Mailchimp campaign by id. Returns the updated campaign including id, type, status, recipients, settings, and tracking. Required: id, settings.

delete_a_mailchimp_campaign_by_id

Delete a Mailchimp campaign by id. Returns an empty 204 response on success. Required: id.

mailchimp_campaigns_pause

Pause an RSS-Driven Mailchimp campaign. Returns an empty 204 response on success. Required: campaign_id.

mailchimp_campaigns_replicate

Replicate a Mailchimp campaign in saved or send status. Returns the new campaign object including id, web_id, type, status, create_time, send_time, recipients, and settings. Required: campaign_id.

mailchimp_campaigns_resume

Resume a paused RSS-Driven Mailchimp campaign. Returns an empty 204 response on success. Required: campaign_id.

mailchimp_campaigns_schedule

Schedule a Mailchimp campaign for delivery at a specific UTC time. Returns an empty 204 response on success. Required: campaign_id, schedule_time. Campaigns may only be scheduled on the quarter-hour (:00, :15, :30, :45). Use the send action instead for Multivariate Campaigns testing send times or RSS Campaigns.

mailchimp_campaigns_send

Send a Mailchimp campaign immediately, or according to its schedule for RSS campaigns. Returns an empty 204 response on success. Required: campaign_id.

mailchimp_campaigns_test

Send a test email for a Mailchimp campaign to specified recipients. Returns an empty 204 response on success. Required: campaign_id, test_emails, send_type.

mailchimp_campaigns_cancel_send

Cancel a Regular or Plain-Text Mailchimp campaign after sending, before all recipients receive it. This feature requires Mailchimp Pro. Returns an empty 204 response on success. Required: campaign_id.

mailchimp_campaigns_create_resend

Resend a Mailchimp campaign to a specific segment using a shortcut — non-openers, new subscribers, non-clickers, or non-purchasers. Returns the replicated Campaign object including id, type, status, recipients, send_time, and resendable. Required: campaign_id.

mailchimp_campaigns_unschedule

Unschedule a scheduled Mailchimp campaign that hasn't started sending. Returns an empty 204 response on success. Required: campaign_id.

list_all_mailchimp_campaign_folders

List Mailchimp campaign folders used to organize campaigns. Returns each folder's id, name, count, and _links. Use fields or exclude_fields to control which fields are returned.

get_single_mailchimp_campaign_folder_by_id

Get a single Mailchimp campaign folder by id. Returns: id, count, _links, x-title. Required: id.

create_a_mailchimp_campaign_folder

Create a new Mailchimp campaign folder. Returns: name, id, count, _links. Required: name.

update_a_mailchimp_campaign_folder_by_id

Update a Mailchimp campaign folder by id. Returns: id, count, _links. Required: id, name.

delete_a_mailchimp_campaign_folder_by_id

Delete a Mailchimp campaign folder by id. All campaigns in the deleted folder are marked as 'unfiled'. Returns an empty 204 response on success. Required: id.

list_all_mailchimp_files

List Mailchimp File Manager files stored in the account. Returns: id, folder_id, type, name, full_size_url, thumbnail_url, size, created_at, created_by, width, height, _links. Max 1000 records per page.

get_single_mailchimp_file_by_id

Get a single Mailchimp File Manager file by id. Returns: id, folder_id, type, name, full_size_url, thumbnail_url, size, created_at, created_by, width, height, _links. Required: id.

create_a_mailchimp_file

Upload a new image or file to the Mailchimp File Manager. Returns the created file object including id, name, type, full_size_url, size, and created_at. Required: name, file_data.

update_a_mailchimp_file_by_id

Update a Mailchimp File Manager file's name or folder by id. Returns the updated file object including id, name, folder_id, type, full_size_url, and size. Setting folder_id to 0 removes the file from its current folder. Required: id.

list_all_mailchimp_file_folders

List all folders in the Mailchimp File Manager. Returns: id, name, file_count, created_at, created_by, _links. Supports filtering by created_by, before_created_at, and since_created_at.

get_single_mailchimp_file_folder_by_id

Get a specific Mailchimp File Manager folder by id. Returns: id, name, file_count, created_at, created_by, _links. Required: id.

create_a_mailchimp_file_folder

Create a new folder in the Mailchimp File Manager. Returns: id, name, file_count, created_at, created_by, _links. Required: name.

update_a_mailchimp_file_folder_by_id

Update a specific Mailchimp File Manager folder by id. Returns: id, name, file_count, created_at, created_by, _links. Required: id.

list_all_mailchimp_templates

List Mailchimp email templates for an account, with optional filters by creator, date range, type, category, folder, and content_type. Returns: id, type, name, drag_and_drop, responsive, category, date_created, date_edited, created_by, edited_by, active, folder_id, thumbnail, share_url, content_type, _links. Sort by date_created, date_edited, or name in ascending or descending order. Max 1000…

get_single_mailchimp_template_by_id

Get a single Mailchimp email template by id. Returns: id, type, drag_and_drop, responsive, category, date_created, date_edited, created_by, edited_by, active, folder_id, thumbnail, share_url, content_type, _links, x-title. Required: id.

create_a_mailchimp_template

Add template. Returns: id, type, name, drag_and_drop, responsive, category, date_created, date_edited. Required: name, html.

update_a_mailchimp_template_by_id

Update template. Returns: id, type, name, drag_and_drop, responsive, category, date_created, date_edited. Required: id, name, html.

delete_a_mailchimp_template_by_id

Delete a Mailchimp template by id. Returns an empty 204 response on success. Required: id.

list_all_mailchimp_template_folders

List Mailchimp template folders used to organize templates. Returns each folder with id, name, count, and _links. Max 1000 records per page.

get_single_mailchimp_template_folder_by_id

Get a single Mailchimp template folder by id. Returns: id, count, _links, x-title. Required: id.

create_a_mailchimp_template_folder

Create a new Mailchimp template folder. Returns: name, id, count, _links. Required: name.

update_a_mailchimp_template_folder_by_id

Update a Mailchimp template folder by id. Returns: id, count, _links. Required: id.

delete_a_mailchimp_template_folder_by_id

Delete a Mailchimp template folder by id. All templates previously in the folder are marked as 'unfiled'. Returns an empty 204 response on success. Required: id.

list_all_mailchimp_lists

List all Mailchimp subscriber lists (audiences) in the account. Returns each list with id, name, web_id, date_created, list_rating, contact, campaign_defaults, stats, and subscribe URLs. Filter by creation date, campaign send date, subscriber email, or ecommerce store connection; sort by date_created ascending or descending. Max 1000 records per page.

get_single_mailchimp_list_by_id

Get a single Mailchimp subscriber list (audience) by id. Returns the full list object including id, name, web_id, date_created, list_rating, contact, campaign_defaults, stats, and subscribe URLs. Required: id.

create_a_mailchimp_list

Create a new list in Mailchimp. Returns the created list including id, web_id, name, contact, campaign_defaults, date_created, list_rating, stats, visibility, and subscribe URLs. Required: name, permission_reminder, email_type_option, contact, campaign_defaults.

update_a_mailchimp_list_by_id

Update the settings for a specific Mailchimp list by id. Returns the updated list including id, web_id, name, contact, campaign_defaults, date_created, list_rating, stats, and visibility. Required: id, name, permission_reminder, email_type_option, contact, campaign_defaults.

delete_a_mailchimp_list_by_id

Delete a Mailchimp list by id. Permanently removes all list history including subscriber activity, unsubscribes, complaints, bounces, and subscriber email addresses. Returns an empty 204 response on success. Required: id.

mailchimp_lists_list_activity

List up to 180 days of daily aggregated activity stats for a Mailchimp list, excluding Automation activity. Returns: day, emails_sent, unique_opens, recipient_clicks, hard_bounce, soft_bounce, subs, unsubs, other_adds, other_removes, _links. Required: list_id.

mailchimp_lists_list_webhooks

List all webhooks configured for a specific Mailchimp list. Returns: id, url, events, sources, list_id, _links. Required: list_id.

mailchimp_lists_attach_webhook

Create a new webhook for a specific Mailchimp list. Returns the created webhook including id, url, events, sources, list_id, and _links. Required: list_id.

list_all_mailchimp_members

List members of a specific Mailchimp list, including currently subscribed, unsubscribed, and bounced members. Returns: id, email_address, unique_email_id, contact_id, full_name, web_id, email_type, status, unsubscribe_reason, consents_to_one_to_one_messaging, sms_phone_number, sms_subscription_status, sms_subscription_last_updated, merge_fields, interests, stats, ip_signup, timestamp_signup,…

get_single_mailchimp_member_by_id

Get information about a specific Mailchimp list member by id, including currently subscribed, unsubscribed, or bounced members. Returns: id, email_address, unique_email_id, contact_id, full_name, web_id, email_type, status, unsubscribe_reason, consents_to_one_to_one_messaging, sms_phone_number, sms_subscription_status, sms_subscription_last_updated, merge_fields, interests, stats, ip_signup,…

create_a_mailchimp_member

Add a new member to a Mailchimp list. Returns: id, email_address, unique_email_id, contact_id, full_name, web_id, email_type, status, unsubscribe_reason, consents_to_one_to_one_messaging, sms_phone_number, sms_subscription_status, sms_subscription_last_updated, merge_fields, interests, stats, ip_signup, timestamp_signup, ip_opt, timestamp_opt, member_rating, last_changed, language, vip,…

update_a_mailchimp_member_by_id

Update information for a specific Mailchimp list member. Returns: id, email_address, unique_email_id, contact_id, full_name, web_id, email_type, status, unsubscribe_reason, consents_to_one_to_one_messaging, sms_phone_number, sms_subscription_status, sms_subscription_last_updated, merge_fields, interests, stats, ip_signup, timestamp_signup, ip_opt, timestamp_opt, member_rating, last_changed,…

mailchimp_members_search

Search for Mailchimp list members by email address or contact name, optionally restricted to a specific list. Returns: exact_matches, full_search, _links. Required: query.

mailchimp_members_upsert

Add or update a list member in Mailchimp by email address — creates a new subscriber if the address is not yet on the list, or updates the existing member if it is. Returns the full member object including id, email_address, status, merge_fields, vip, and tags. Required: list_id, email_address, status_if_new.

list_all_mailchimp_tags

Search for tags on a Mailchimp list by name. Returns: id, name. If no name query is provided, all tags on the list are returned. Required: list_id.

list_all_mailchimp_accounts

List Mailchimp account details from the Marketing API root. Returns: account_id, login_id, account_name, email, account_role, pricing_plan_type, first_name, last_name, member_count, total_subscribers. Optional fields and exclude_fields query parameters control which fields are returned.

list_all_mailchimp_oauth_metadata

Get Mailchimp OAuth metadata for the authenticated user. Returns the server prefix (dc) needed to route all subsequent Marketing API requests on the user's behalf. No request parameters required.

list_all_mailchimp_account_exports

List Mailchimp account exports. Returns: export_id, started, finished, size_in_bytes, download_url, _links. Max 1000 records per page.

create_a_mailchimp_account_export

Create a new account export in your Mailchimp account. Returns: export_id, started, finished, size_in_bytes, download_url, _links. Required: include_stages.

get_single_mailchimp_account_export_by_id

Get information about a specific Mailchimp account export by id. Returns: export_id, started, finished, size_in_bytes, download_url, _links, x-title. Required: id.

list_all_mailchimp_activity_feed_chimp_chatters

List Mailchimp chimp chatter activity feed messages ordered by most recent. Returns: title, message, type, update_time, url, list_id, campaign_id. A maximum of 200 messages exist per account and up to 1000 can be returned per request.

list_all_mailchimp_audience_contacts

List Mailchimp audience contacts with optional date-range and sort filters. Returns each contact's id, audience_id, language, status, email_channel, sms_channel, merge_fields, tags, source, created_at, and last_updated_at. Required: audience_id. Max 1000 records per page.

create_a_mailchimp_audience_contact

Create a new omni-channel contact in a Mailchimp audience. Returns the created contact including id, audience_id, language, status, email_channel, sms_channel, merge_fields, tags, source, created_at, and last_updated_at. Required: audience_id.

get_single_mailchimp_audience_contact_by_id

Get a single Mailchimp audience contact by id. Returns the full contact including id, audience_id, language, status, email_channel, sms_channel, merge_fields, tags, source, created_at, and last_updated_at. Required: audience_id, id.

mailchimp_audience_contacts_bulk_update

Update an existing Mailchimp audience contact by contact_id. Returns the updated contact including id, audience_id, language, status, email_channel, sms_channel, merge_fields, tags, source, created_at, and last_updated_at. Required: audience_id, contact_id.

mailchimp_audience_contacts_archive

Archive a Mailchimp audience contact by contact_id. Returns an empty 204 response on success. Required: audience_id, contact_id.

mailchimp_audience_contacts_forget

Forget a Mailchimp contact within a specific audience, removing the contact's personal data in compliance with privacy regulations. Returns an empty 204 response on success. Required: audience_id, contact_id.

list_all_mailchimp_audiences

List Mailchimp audiences in the account. Returns each audience with id, name, stats, and enabled_channels. Max 1000 records per page.

get_single_mailchimp_audience_by_id

Get a specific Mailchimp audience by id. Returns: id, stats, enabled_channels, x-title. Required: id.

list_all_mailchimp_authorized_apps

List Mailchimp authorized (registered, connected) applications for an account. Returns: id, name, description, users, _links. Max 1000 records per page.

get_single_mailchimp_authorized_app_by_id

Get information about a specific Mailchimp authorized application by id. Returns: id, description, users, _links, x-title. Required: id.

list_all_mailchimp_automation_emails

List automated emails in a Mailchimp classic automation workflow. Returns each email with id, web_id, workflow_id, position, delay, create_time, start_time, archive_url, status, emails_sent, send_time, content_type, recipients, and related settings. Required: workflow_id.

get_single_mailchimp_automation_email_by_id

Get information about a specific Mailchimp automation workflow email. Returns the full email object including id, web_id, workflow_id, position, delay, create_time, start_time, archive_url, status, emails_sent, send_time, content_type, recipients, and related settings. Required: workflow_id, id.

mailchimp_automation_emails_bulk_update

Update workflow email. Returns: id, web_id, workflow_id, position, delay, create_time, start_time, archive_url. Required: workflow_id, workflow_email_id.

mailchimp_automation_emails_bulk_delete

Delete an individual classic automation workflow email in Mailchimp. Emails from certain workflow types, including Abandoned Cart Email and Product Retargeting Email workflows, cannot be deleted. Returns an empty 204 response on success. Required: workflow_id, workflow_email_id.

mailchimp_automation_emails_pause

Pause an automated email in a Mailchimp classic automation workflow. Returns an empty 204 response on success. Required: workflow_id, workflow_email_id.

mailchimp_automation_emails_start

Start a Mailchimp automated email, triggering it to begin sending. Returns an empty 204 response on success. Required: workflow_id, workflow_email_id.

list_all_mailchimp_automation_removed_subscribers

List subscribers who were removed from a Mailchimp classic automation workflow. Returns: id, workflow_id, list_id, email_address, _links. Required: workflow_id.

create_a_mailchimp_automation_removed_subscriber

Remove a subscriber from a Mailchimp classic automation workflow. Once removed, the subscriber can never be added back to the same workflow. Returns: id, workflow_id, list_id, email_address, _links. Required: workflow_id, email_address.

list_all_automation_removed_subscribers_removed_subscribers

Get information about a specific Mailchimp subscriber who was removed from a classic automation workflow. Returns: id, workflow_id, list_id, email_address, _links, fired_at, data. Required: workflow_id, subscriber_hash.

list_all_mailchimp_automations

List Mailchimp classic automations with optional filtering by creation/start time and status. Returns each automation's id, create_time, start_time, status, emails_sent, and recipients.

create_a_mailchimp_automation

Create a new classic automation in your Mailchimp account. Returns the created automation including id, create_time, start_time, status, emails_sent, and recipients. Required: recipients, trigger_settings.

get_single_mailchimp_automation_by_id

Get a single Mailchimp classic automation workflow by id. Returns: id, create_time, start_time, status, emails_sent, recipients, settings, tracking, trigger_settings, report_summary, _links. Required: id.

mailchimp_automations_pause_all_emails

Pause all emails in a specific Mailchimp classic automation workflow. Returns an empty 204 response on success. Required: workflow_id.

mailchimp_automations_start_all_emails

Start all emails in a Mailchimp classic automation workflow. Returns an empty 204 response on success. Required: workflow_id.

mailchimp_automations_archive

Archive a Mailchimp automation workflow, permanently ending it. Report data is retained and the workflow can be replicated but not restarted. Returns an empty 204 response on success. Required: workflow_id.

list_all_mailchimp_batch_webhooks

List all Mailchimp batch webhooks configured for batch request completion notifications. Returns: id, url, enabled, _links.

create_a_mailchimp_batch_webhook

Create a new Mailchimp batch webhook that fires whenever any batch request completes processing. Returns: id, url, enabled, _links. Required: url. Maximum of 20 batch webhooks allowed.

get_single_mailchimp_batch_webhook_by_id

Get information about a specific Mailchimp batch webhook by id. Returns: id, url, enabled, _links, x-title. Required: id.

update_a_mailchimp_batch_webhook_by_id

Update a Mailchimp batch webhook's URL or enabled status by id. Returns: id, url, enabled, _links. Required: id.

delete_a_mailchimp_batch_webhook_by_id

Delete a Mailchimp batch webhook by id. Webhooks will no longer be sent to the configured URL. Returns an empty 204 response on success. Required: id.

list_all_mailchimp_batches

List Mailchimp batch requests. Returns: id, status, total_operations, finished_operations, errored_operations, submitted_at, completed_at, response_body_url, _links. Max 1000 records per page.

create_a_mailchimp_batch

Start a Mailchimp batch operation by submitting an array of operations. Returns: id, status, total_operations, finished_operations, errored_operations, submitted_at, completed_at, response_body_url, _links. Required: operations.

get_single_mailchimp_batch_by_id

Get the status of a Mailchimp batch request by id. Returns: id, status, total_operations, finished_operations, errored_operations, submitted_at, completed_at, response_body_url, _links, x-title. Required: id.

delete_a_mailchimp_batch_by_id

Stop a Mailchimp batch request from running by id. Results of any completed operations will not be available after deletion. Returns an empty 204 response on success. Required: id.

list_all_mailchimp_email_queues

List subscribers in a Mailchimp classic automation email queue. Returns: id, workflow_id, email_id, list_id, email_address, next_send, _links. Required: workflow_id, workflow_email_id.

create_a_mailchimp_email_queue

Manually add a subscriber to a Mailchimp automation workflow email, bypassing the default trigger settings. Returns: id, workflow_id, email_id, list_id, list_is_active, email_address, next_send, _links. Required: workflow_id, workflow_email_id, email_address.

list_all_mailchimp_email_queues_queue

Get information about a specific subscriber in a Mailchimp classic automation email queue. Returns: id, workflow_id, email_id, list_id, list_is_active, email_address, next_send, _links, fired_at, data. Required: workflow_id, workflow_email_id, subscriber_hash.

list_all_mailchimp_campaign_feedbacks

List team feedback for a Mailchimp campaign. Returns: feedback_id, parent_id, block_id, message, is_complete, created_by, created_at, updated_at, source, campaign_id, _links. Required: campaign_id.

get_single_mailchimp_campaign_feedback_by_id

Get a specific feedback message from a Mailchimp campaign by id. Returns: feedback_id, parent_id, block_id, message, is_complete, created_by, created_at, updated_at, source, campaign_id, _links, fired_at, data. Required: campaign_id, id.

create_a_mailchimp_campaign_feedback

Add feedback to a Mailchimp campaign. Returns the created feedback object including feedback_id, message, is_complete, created_by, created_at, source, and campaign_id. Required: campaign_id, message.

mailchimp_campaign_feedbacks_bulk_update

Update a specific feedback message for a Mailchimp campaign. Returns the updated feedback object including feedback_id, message, is_complete, created_by, created_at, updated_at, source, and campaign_id. Required: campaign_id, feedback_id.

mailchimp_campaign_feedbacks_bulk_delete

Delete a specific feedback message from a Mailchimp campaign. Returns an empty 204 response on success. Required: campaign_id, feedback_id.

list_all_mailchimp_campaign_send_checklists

Get the send checklist for a Mailchimp campaign to review readiness and resolve any issues before sending. Returns: is_ready, items, _links, x-title. Required: campaign_id.

list_all_mailchimp_connected_sites

List all connected sites in a Mailchimp account. Returns each site's foreign_id, domain, platform, store_id, site_script, is_pixel_enabled, created_at, and updated_at.

get_single_mailchimp_connected_site_by_id

Get a specific Mailchimp connected site by id. Returns: foreign_id, store_id, platform, domain, site_script, is_pixel_enabled, created_at, updated_at, _links, x-title. Required: id.

create_a_mailchimp_connected_site

Create a new Mailchimp connected site. Returns: foreign_id, store_id, platform, domain, site_script, is_pixel_enabled, created_at, updated_at, _links. Required: foreign_id, domain.

delete_a_mailchimp_connected_site_by_id

Delete a Mailchimp connected site by id. Returns an empty 204 response on success. Required: id.

mailchimp_connected_sites_verify_script_installation

Verify that the Mailchimp connected sites script has been installed, either via the script URL or fragment. Returns an empty 204 response on success. Required: connected_site_id.

mailchimp_connected_sites_enable_pixel

Enable the Mailchimp tracking pixel for a connected site. Returns an empty 204 response on success. Required: connected_site_id.

mailchimp_connected_sites_disable_pixel

Disable the Mailchimp tracking pixel for a connected site. Returns an empty 204 response on success. Required: connected_site_id.

list_all_mailchimp_contents

Get the HTML and plain-text content for a Mailchimp campaign. Returns: variate_contents, plain_text, html, archive_html, _links, x-title. Required: campaign_id.

mailchimp_contents_bulk_update

Set the HTML and plain-text content for a Mailchimp campaign, with support for templates, archives, URLs, and multivariate content options. Returns: variate_contents, plain_text, html, archive_html, _links. Required: campaign_id.

list_all_mailchimp_conversations

List Mailchimp conversations for the account. Returns: id, message_count, campaign_id, list_id, unread_messages, from_label, from_email, subject, last_message, _links. Conversations are deprecated in favor of Inbox; past conversations remain but new campaign replies are excluded.

get_single_mailchimp_conversation_by_id

Get a single Mailchimp conversation by id. Returns: id, message_count, campaign_id, list_id, unread_messages, from_label, from_email, subject, last_message, _links, x-title. Required: id. Deprecated in favor of Inbox.

mailchimp_conversations_list_messages

List messages from a specific Mailchimp conversation. Returns: id, conversation_id, list_id, from_label, from_email, subject, message, read, timestamp, _links. Required: conversation_id. Deprecated in favor of Inbox.

list_all_mailchimp_conversation_messages

Get an individual Mailchimp conversation message by conversation and message id. Returns: id, conversation_id, list_id, from_label, from_email, subject, message, read, timestamp, _links, x-title. Required: conversation_id, message_id. Conversations has been deprecated in favor of Inbox; new campaign replies and Inbox messages are not available via this endpoint.

delete_a_mailchimp_file_manager_file_by_id

Delete a Mailchimp File Manager file by id. Returns an empty 204 response on success. Required: id.

delete_a_mailchimp_file_manager_folder_by_id

Delete a Mailchimp File Manager folder by id. Returns an empty 204 response on success. Required: id.

list_all_mailchimp_folder_files

List images and files stored in a Mailchimp File Manager folder. Returns each file with id, name, type, full_size_url, thumbnail_url, size, and created_at. Required: folder_id.

list_all_mailchimp_interest_categorie_interests

List Mailchimp interests (group names) within a specific interest category. Returns: category_id, list_id, id, name, subscriber_count, display_order, _links. Required: list_id, interest_category_id.

get_single_mailchimp_interest_categorie_interest_by_id

Get a single Mailchimp interest (group name) by id within a specific category. Returns: category_id, list_id, id, name, subscriber_count, display_order, _links, fired_at, data. Required: list_id, interest_category_id, id.

create_a_mailchimp_interest_categorie_interest

Create a new Mailchimp interest (group name) in a specific category. Returns: category_id, list_id, id, subscriber_count, display_order, _links, x-title, name. Required: list_id, interest_category_id, name.

mailchimp_interest_categorie_interests_bulk_update

Update a Mailchimp interest (group name) by interest_id within a specific category. Returns: category_id, list_id, id, name, subscriber_count, display_order, _links, fired_at, data. Required: list_id, interest_category_id, interest_id.

mailchimp_interest_categorie_interests_bulk_delete

Delete a Mailchimp interest (group name) by interest_id from a specific category. Returns an empty 204 response on success. Required: list_id, interest_category_id, interest_id.

mailchimp_journey_steps_trigger

Trigger a Mailchimp Customer Journeys API step for a contact in an Automation flow. The journey_id and step_id are obtained from the URL Mailchimp provides when you create a Customer Journey API starting point or step in the flow builder. Returns an empty 204 response on success. Required: journey_id, step_id, email_address.

list_all_mailchimp_list_abuse_reports

List Mailchimp abuse reports for a specific list. Returns: id, campaign_id, list_id, email_id, email_address, merge_fields, vip, date, _links. Required: list_id.

get_single_mailchimp_list_abuse_report_by_id

Get a specific Mailchimp abuse report by id. Returns: id, campaign_id, list_id, email_id, email_address, merge_fields, vip, date, _links. Required: list_id, id.

list_all_mailchimp_list_clients

List the top email clients used by subscribed members of a Mailchimp list, based on user-agent strings. Returns: client, members. Required: list_id.

list_all_mailchimp_list_growth_histories

List month-by-month growth history for a Mailchimp list. Returns: list_id, month, existing, imports, optins, subscribed, unsubscribed, reconfirm, cleaned, pending, deleted, transactional, _links. Required: list_id. The existing, imports, and optins fields are deprecated.

list_all_mailchimp_list_growth_histories_growth_history

Get a Mailchimp list's growth history for a specific month and year. Returns: list_id, month, existing, imports, optins, subscribed, unsubscribed, reconfirm, cleaned, pending, deleted, transactional, _links. Required: list_id, month.

list_all_mailchimp_list_interest_categories

List Mailchimp interest categories for a specific list. Returns each category with id, list_id, title, display_order, and type. Required: list_id.

get_single_mailchimp_list_interest_category_by_id

Get a single Mailchimp interest category by id. Returns: list_id, id, title, display_order, type, _links, fired_at, data. Required: list_id, id.

create_a_mailchimp_list_interest_category

Create a new interest category for a Mailchimp list. Returns the created category including id, list_id, title, display_order, type, and _links. Required: list_id, title, type.

mailchimp_list_interest_categories_bulk_update

Update a specific Mailchimp interest category. Returns the updated category including id, list_id, title, display_order, type, and _links. Required: list_id, interest_category_id.

mailchimp_list_interest_categories_bulk_delete

Delete a specific Mailchimp interest category. Returns an empty 204 response on success. Required: list_id, interest_category_id.

list_all_mailchimp_list_segments

List Mailchimp segments for a specific list, with optional filtering by segment type, creation/update timestamps, and member status inclusion. Returns: id, name, member_count, type, created_at, updated_at, options, list_id, _links. Required: list_id. Max 1000 records per page.

get_single_mailchimp_list_segment_by_id

Get a single Mailchimp segment by id. Returns: id, name, member_count, type, created_at, updated_at, options, list_id, _links. Required: list_id, id.

create_a_mailchimp_list_segment

Create a new Mailchimp segment in a specific list. Returns the created segment including id, name, member_count, type, created_at, updated_at, and options. Required: list_id, name. The static_segment and options fields are mutually exclusive.

update_a_mailchimp_list_segment_by_id

Update a specific Mailchimp segment by id. Returns the updated segment including id, name, member_count, type, created_at, updated_at, and options. Required: list_id, id, name. The static_segment and options fields are mutually exclusive.

mailchimp_list_segments_attach_member

Add a member to a Mailchimp static segment. Returns the list member object including id, email_address, full_name, status, unique_email_id, and member_rating. Required: list_id, segment_id, email_address.

mailchimp_list_segments_bulk_update

Update segment. Returns: id, name, member_count, type, created_at, updated_at, options, list_id. Required: list_id, segment_id, name.

mailchimp_list_segments_bulk_delete

Delete a specific segment in a Mailchimp list. Returns an empty 204 response on success. Required: list_id, segment_id.

mailchimp_list_segments_list_members

List Mailchimp list members belonging to a saved segment. Returns: id, email_address, full_name, unique_email_id, email_type, status, merge_fields, interests, stats, ip_signup, timestamp_signup, ip_opt, timestamp_opt, member_rating, last_changed, language, vip, email_client, location, last_note, list_id, _links. Required: list_id, segment_id. Max 1000 per page.

update_a_mailchimp_lists_3_0_by_id

Batch subscribe or unsubscribe. Returns: new_members, updated_members, errors, total_created, total_updated, error_count, _links. Required: id, members.

list_all_mailchimp_landing_page_contents

Get the HTML content for a Mailchimp landing page by page_id. Returns: html, json, _links, x-title. Required: page_id.

list_all_mailchimp_landing_pages

List Mailchimp landing pages with optional sorting and field selection. Returns: id, name, title, description, template_id, status, list_id, store_id, web_id, created_by_source, url, created_at, published_at, unpublished_at, updated_at, tracking, _links. Max 1000 records per page.

get_single_mailchimp_landing_page_by_id

Get a single Mailchimp landing page by id. Returns: id, title, description, template_id, status, list_id, store_id, web_id, created_by_source, url, created_at, published_at, unpublished_at, updated_at, tracking, _links, x-title. Required: id.

create_a_mailchimp_landing_page

Create an unpublished, contentless Mailchimp landing page. Returns: id, title, description, template_id, status, list_id, store_id, web_id, created_by_source, url, created_at, published_at, unpublished_at, updated_at, tracking, _links, x-title.

update_a_mailchimp_landing_page_by_id

Update a Mailchimp landing page by id. Returns: id, title, description, template_id, status, list_id, store_id, web_id, created_by_source, url, created_at, published_at, unpublished_at, updated_at, tracking, _links, x-title. Required: id.

delete_a_mailchimp_landing_page_by_id

Delete a Mailchimp landing page by id. Returns an empty 204 response on success. Required: id.

mailchimp_landing_pages_publish

Publish a Mailchimp landing page that is in draft, unpublished, or has been previously published and edited. Returns an empty 204 response on success. Required: page_id.

mailchimp_landing_pages_unpublish

Unpublish a Mailchimp landing page that is in draft or has been published. Returns an empty 204 response on success. Required: page_id.

list_all_mailchimp_list_locations

List Mailchimp subscriber locations (countries) for a list, based on geocoding subscribers' IP addresses. Returns: country, cc, percent, total. Required: list_id.

mailchimp_list_members_attach_event

Add an event for a Mailchimp list member. Returns an empty 204 response on success. Required: list_id, subscriber_hash, name. The event name must be 2-30 characters in length.

mailchimp_list_members_attach_tag

Add or remove tags on a Mailchimp list member. Returns an empty 204 response on success. Required: list_id, subscriber_hash, tags. New tags are created automatically when set to active.

mailchimp_list_members_bulk_delete

Archive a Mailchimp list member. Returns an empty 204 response on success. Required: list_id, subscriber_hash. Use delete-permanent to permanently remove a member.

mailchimp_list_members_delete_permanent

Permanently delete a Mailchimp list member and all associated personally identifiable information. Returns an empty 204 response on success. Required: list_id, subscriber_hash. Re-importing the member is not possible after this action.

mailchimp_list_members_list_activity

List the last 50 activity events for a Mailchimp list member, including opens, clicks, and unsubscribes. Returns: action, timestamp, url, type, campaign_id, title, parent_campaign. Required: list_id, subscriber_hash.

mailchimp_list_members_list_events

List events for a Mailchimp list member. Returns: occurred_at, name, properties. Required: list_id, subscriber_hash. Max 1000 records per page.

mailchimp_list_members_list_tags

List tags assigned to a Mailchimp list member. Returns: id, name, date_added. Required: list_id, subscriber_hash. Max 1000 records per page.

list_all_mailchimp_list_merge_fields

List all merge fields for a Mailchimp audience, filterable by type and required status. Returns: merge_id, tag, name, type, required, default_value, public, display_order, options, help_text, list_id, total_items, merge_field_limit, _links. Required: list_id.

get_single_mailchimp_list_merge_field_by_id

Get information about a specific Mailchimp merge field. Returns: merge_id, tag, name, type, required, default_value, public, display_order, options, help_text, list_id, total_items, merge_field_limit, _links, fired_at, data. Required: list_id, id.

create_a_mailchimp_list_merge_field

Create a new merge field for a Mailchimp audience. Returns the created merge field including merge_id, tag, name, type, required, default_value, public, display_order, options, help_text, list_id, total_items, merge_field_limit, and _links. Required: list_id, name, type.

mailchimp_list_merge_fields_bulk_update

Update a specific Mailchimp merge field for a list. Returns the updated merge field including merge_id, tag, name, type, required, default_value, public, display_order, options, help_text, list_id, total_items, merge_field_limit, and _links. Required: list_id, merge_id, name.

mailchimp_list_merge_fields_bulk_delete

Delete a specific Mailchimp merge field. Returns an empty 204 response on success. Required: list_id, merge_id.

list_all_mailchimp_list_signup_forms

List signup forms for a specific Mailchimp list. Returns: header, contents, styles, signup_form_url, list_id, _links. Required: list_id.

create_a_mailchimp_list_signup_form

Customize a Mailchimp list's default signup form by setting header options, body content, and element styles. Returns: header, contents, styles, signup_form_url, list_id, _links, x-title. Required: list_id.

list_all_mailchimp_list_surveys

List all Mailchimp surveys for a specific audience list. Returns each survey with its id, title, and sections. Required: list_id.

get_single_mailchimp_list_survey_by_id

Get details about a specific Mailchimp survey by id. Returns: id, title, sections. Required: list_id, id.

create_a_mailchimp_list_survey

Create a draft Mailchimp survey for an audience. Returns the created survey including its id, title, and sections. Required: list_id.

mailchimp_list_surveys_bulk_update

Update a Mailchimp survey's title, inbox piping setting, and full section list. Returns: id, title, is_piped_to_inbox, sections. Required: list_id, survey_id. When sections is provided, send the complete list in display order—any section omitted is deleted.

mailchimp_list_surveys_bulk_delete

Delete a Mailchimp survey associated with a specific list. Returns an empty 204 response on success. Required: list_id, survey_id.

mailchimp_list_surveys_publish

Publish a Mailchimp survey that is in draft, unpublished, or has been previously published and edited. Returns an empty response on success. Required: list_id, survey_id.

mailchimp_list_surveys_unpublish

Unpublish a Mailchimp survey that has been published. Returns an empty response on success. Required: list_id, survey_id.

mailchimp_list_surveys_create_email

Create a Mailchimp survey campaign linked to a survey using the list and survey IDs. Returns the campaign object including id, web_id, type, status, create_time, and archive_url. Required: list_id, survey_id.

mailchimp_list_surveys_replicate

Replicate survey. Required: list_id, survey_id.

list_all_mailchimp_list_webhooks

Get information about a specific Mailchimp list webhook. Returns: id, url, events, sources, list_id, _links, x-title. Required: list_id, webhook_id.

mailchimp_list_webhooks_bulk_update

Update the settings for an existing Mailchimp list webhook. Returns the updated webhook object including id, url, events, sources, and list_id. Required: list_id, webhook_id.

mailchimp_list_webhooks_bulk_delete

Delete a specific Mailchimp list webhook. Returns an empty 204 response on success. Required: list_id, webhook_id.

list_all_mailchimp_member_activity_feeds

List a Mailchimp list member's recent activity including opens, clicks, bounces, and unsubscribes. Returns: activity_type, created_at_timestamp, campaign_id, campaign_title, link_clicked, bounce_type, bounce_has_open_activity, is_admin_unsubscribed, unsubscribe_reason, thread_id, message_text, created_by, is_user, has_read, from_email, avatar_url, updated_at_timestamp, note_id, note_text,…

list_all_mailchimp_member_goals

List the last 50 Mailchimp goal events for a member on a specific list. Returns: goal_id, event, last_visited_at, data. Required: list_id, subscriber_hash. Limited to the most recent 50 goal events.

list_all_mailchimp_member_notes

List recent member notes for a specific Mailchimp list member. Returns: id, created_at, created_by, updated_at, note, list_id, email_id, contact_id, _links. Required: list_id, subscriber_hash.

get_single_mailchimp_member_note_by_id

Get a specific Mailchimp member note by id. Returns: id, created_at, created_by, updated_at, note, list_id, email_id, contact_id, _links, title, status, detail, instance. Required: list_id, subscriber_hash, id.

create_a_mailchimp_member_note

Create a new note for a specific Mailchimp list member. Returns the created note object including id, created_at, created_by, updated_at, note, list_id, email_id, and contact_id. Required: list_id, subscriber_hash.

mailchimp_member_notes_bulk_update

Update a specific Mailchimp member note. Returns the updated note object including id, created_at, created_by, updated_at, note, list_id, email_id, and contact_id. Required: list_id, subscriber_hash, note_id.

mailchimp_member_notes_bulk_delete

Delete a specific Mailchimp member note. Returns an empty 204 response on success. Required: list_id, subscriber_hash, note_id.

list_all_mailchimp_report_abuse_reports

List abuse complaint reports for a specific Mailchimp campaign. Returns: id, campaign_id, list_id, list_is_active, email_id, email_address, merge_fields, vip, date, _links. Required: campaign_id.

get_single_mailchimp_report_abuse_report_by_id

Get a single Mailchimp abuse report for a specific campaign by id. Returns: id, campaign_id, list_id, list_is_active, email_id, email_address, merge_fields, vip, date, _links. Required: campaign_id, id.

list_all_mailchimp_reports

List Mailchimp campaign reports for sent campaigns. Returns per-report: id, campaign_title, type, list_id, list_name, subject_line, emails_sent, send_time, bounces, opens, clicks, forwards, abuse_reports, unsubscribed, industry_stats, list_stats, and ab_split stats. Filter by campaign type or send-time range. Max 1000 records per page.

get_single_mailchimp_report_by_id

Get a Mailchimp campaign report for a specific sent campaign by id. Returns: id, campaign_title, type, list_id, list_is_active, list_name, subject_line, preview_text, emails_sent, abuse_reports, unsubscribed, send_time, rss_last_send, bounces, forwards, opens, clicks, facebook_likes, industry_stats, list_stats, ab_split, timewarp, timeseries, share_report, ecommerce, delivery_status, _links,…

mailchimp_segment_members_bulk_delete

Remove a Mailchimp list member from a specified static segment. Returns an empty 204 response on success. Required: list_id, segment_id, subscriber_hash.

list_all_mailchimp_cart_lines

List Mailchimp cart line items for a specific cart. Returns: id, product_id, product_title, product_variant_id, product_variant_title, quantity, price, _links. Required: store_id, cart_id. Max 1000 records per page.

get_single_mailchimp_cart_line_by_id

Get a single Mailchimp cart line item by id. Returns: id, product_id, product_title, product_variant_id, product_variant_title, quantity, price, _links. Required: store_id, cart_id, id.

create_a_mailchimp_cart_line

Add a new line item to an existing Mailchimp cart. Returns: id, product_id, product_title, product_variant_id, product_variant_title, quantity, price, _links, x-title. Required: store_id, cart_id, id, product_id, product_variant_id, quantity, price.

mailchimp_cart_lines_bulk_update

Update a specific Mailchimp cart line item. Returns: id, product_id, product_title, product_variant_id, product_variant_title, quantity, price, _links. Required: store_id, cart_id, line_id.

mailchimp_cart_lines_bulk_delete

Delete a specific Mailchimp cart line item. Returns an empty 204 response on success. Required: store_id, cart_id, line_id.

list_all_mailchimp_click_detail_members

List Mailchimp subscribers who clicked on a specific link within a campaign. Returns: email_id, email_address, merge_fields, vip, clicks, campaign_id, url_id, list_id, list_is_active, contact_status, _links. Required: campaign_id, link_id.

list_all_mailchimp_click_detail_members_click_details

Get a specific Mailchimp subscriber who clicked a particular link in a campaign. Returns: email_id, email_address, merge_fields, vip, clicks, campaign_id, url_id, list_id, list_is_active, contact_status, _links. Required: campaign_id, link_id, subscriber_hash.

list_all_mailchimp_ecommerce_orders

List Mailchimp e-commerce orders for an account, optionally filtered by campaign, outreach, or customer. Returns each order with id, customer, store_id, order_total, currency_code, financial_status, lines, and shipping/billing addresses. Max 1000 records per page.

list_all_mailchimp_ecommerce_stores

List all ecommerce stores in the Mailchimp account. Returns: id, list_id, name, platform, domain, is_syncing, email_address, currency_code, money_format, primary_locale, timezone, phone, address, connected_site, automations, list_is_active, created_at, updated_at, _links. Max 1000 records per page.

get_single_mailchimp_ecommerce_store_by_id

Get a Mailchimp ecommerce store by id. Returns: id, list_id, platform, domain, is_syncing, email_address, currency_code, money_format, primary_locale, timezone, phone, address, connected_site, automations, list_is_active, created_at, updated_at, _links, x-title, name. Required: id.

create_a_mailchimp_ecommerce_store

Create a new ecommerce store in your Mailchimp account. Returns: id, list_id, name, platform, domain, is_syncing, email_address, currency_code, money_format, primary_locale, timezone, phone, address, connected_site, automations, list_is_active, created_at, updated_at, _links, title, status, detail, instance. Required: id, list_id, name, currency_code.

update_a_mailchimp_ecommerce_store_by_id

Update a Mailchimp ecommerce store by id. Returns: id, list_id, platform, domain, is_syncing, email_address, currency_code, money_format, primary_locale, timezone, phone, address, connected_site, automations, list_is_active, created_at, updated_at, _links, x-title, name. Required: id.

delete_a_mailchimp_ecommerce_store_by_id

Delete a Mailchimp ecommerce store by id. Deleting a store also deletes any associated subresources, including Customers, Orders, Products, and Carts. Returns an empty 204 response on success. Required: id.

list_all_mailchimp_promo_rule_promo_codes

List Mailchimp promo codes for a store's promo rule. Returns each promo code with id, code, redemption_url, usage_count, enabled, created_at_foreign, and updated_at_foreign. Required: store_id, promo_rule_id.

create_a_mailchimp_promo_rule_promo_code

Add a new promo code to a Mailchimp store's promo rule. Returns the created promo code with id, code, redemption_url, usage_count, enabled, created_at_foreign, and updated_at_foreign. Required: store_id, promo_rule_id, id, code, redemption_url.

get_single_mailchimp_promo_rule_promo_code_by_id

Get a single Mailchimp promo code by id. Returns the promo code with id, code, redemption_url, usage_count, enabled, created_at_foreign, and updated_at_foreign. Required: store_id, promo_rule_id, id.

mailchimp_promo_rule_promo_codes_bulk_update

Update a Mailchimp promo code for a store's promo rule. Returns the updated promo code with id, code, redemption_url, usage_count, enabled, created_at_foreign, and updated_at_foreign. Required: store_id, promo_rule_id, promo_code_id.

mailchimp_promo_rule_promo_codes_bulk_delete

Delete a Mailchimp promo code from a store. Returns an empty 204 response on success. Required: store_id, promo_rule_id, promo_code_id.

list_all_mailchimp_report_advices

List Mailchimp campaign feedback based on a campaign's statistics such as opens, clicks, unsubscribes, and bounces. Returns: type, message, _links. Required: campaign_id.

list_all_mailchimp_report_click_details

List click details for links in a Mailchimp campaign report. Returns: id, url, total_clicks, click_percentage, unique_clicks, unique_click_percentage, last_click, ab_split, campaign_id, _links. Required: campaign_id.

get_single_mailchimp_report_click_detail_by_id

Get click details for a specific link in a Mailchimp campaign report. Returns: id, url, total_clicks, click_percentage, unique_clicks, unique_click_percentage, last_click, ab_split, campaign_id, _links. Required: campaign_id, id.

list_all_mailchimp_report_domain_performances

List domain performance statistics for a Mailchimp campaign, showing the top 5 email domains by delivered emails. Returns: domain, emails_sent, bounces, opens, clicks, unsubs, delivered, emails_pct, bounces_pct, opens_pct, clicks_pct, unsubs_pct. Required: campaign_id.

list_all_mailchimp_report_ecommerce_product_activities

List Mailchimp campaign ecommerce product activity for a specific campaign. Returns: title, sku, image_url, total_revenue, total_purchased, currency_code, recommendation_total, recommendation_purchased. Required: campaign_id. Max 1000 records per page; results can be sorted by title, total_revenue, or total_purchased.

list_all_mailchimp_report_eepurls

List Mailchimp EepURL activity for a campaign, including social engagement and click metrics. Returns: twitter, clicks, referrers, eepurl, campaign_id, total_items, _links, x-title. Required: campaign_id.

list_all_mailchimp_report_email_activities

List member subscriber activity (opens, clicks, and bounces) for a specific Mailchimp campaign. Returns: campaign_id, list_id, list_is_active, email_id, email_address, activity, _links. Required: campaign_id. Member activity is limited to 1,000 open and 1,000 click activities per member per campaign.

list_all_mailchimp_report_email_activities_email_activity

Get a specific Mailchimp list member's email activity in a campaign, including opens, clicks, and bounces. Returns: campaign_id, list_id, list_is_active, email_id, email_address, activity, _links, fired_at, data. Required: campaign_id, subscriber_hash. Activity is limited to 1,000 open and 1,000 click events per member per campaign.

list_all_mailchimp_report_locations

List top open locations for a Mailchimp campaign by geographic region. Returns: country_code, region, region_name, opens, proxy_excluded_opens. Required: campaign_id. Max 1000 records per page.

list_all_mailchimp_report_open_details

List Mailchimp campaign open details showing which list members opened a campaign email. Returns: campaign_id, list_id, list_is_active, contact_status, email_id, email_address, merge_fields, vip, opens_count, proxy_excluded_opens_count, opens, _links. Required: campaign_id. Max 1000 records per page.

list_all_mailchimp_report_open_details_open_details

Get information about a specific Mailchimp campaign subscriber who opened a campaign. Returns: campaign_id, list_id, list_is_active, contact_status, email_id, email_address, merge_fields, vip, opens_count, proxy_excluded_opens_count, opens, _links. Required: campaign_id, subscriber_hash.

list_all_mailchimp_report_sent_tos

List Mailchimp campaign recipients who were sent a specific campaign. Returns: email_id, email_address, merge_fields, vip, status, open_count, last_open, absplit_group, gmt_offset, campaign_id, list_id, list_is_active, _links. Required: campaign_id.

list_all_mailchimp_report_sent_tos_sent_to

Get information about a specific Mailchimp campaign recipient by subscriber hash. Returns: email_id, email_address, merge_fields, vip, status, open_count, last_open, absplit_group, gmt_offset, campaign_id, list_id, list_is_active, _links. Required: campaign_id, subscriber_hash.

list_all_mailchimp_report_sub_reports

List child campaign reports for a specific Mailchimp parent campaign. Returns each sub-report with id, campaign_title, type, list_id, list_name, subject_line, emails_sent, bounces, opens, clicks, ecommerce, delivery_status, and additional engagement statistics. Required: campaign_id.

list_all_mailchimp_report_unsubscribeds

List members who unsubscribed from a specific Mailchimp campaign. Returns: email_id, email_address, merge_fields, vip, timestamp, reason, campaign_id, list_id, list_is_active, _links. Required: campaign_id. Max 1000 records per page.

list_all_mailchimp_report_unsubscribeds_unsubscribed

Get information about a specific Mailchimp list member who unsubscribed from a campaign. Returns: email_id, email_address, merge_fields, vip, timestamp, reason, campaign_id, list_id, list_is_active, _links, fired_at, data. Required: campaign_id, subscriber_hash.

list_all_mailchimp_store_carts

List carts for a Mailchimp store. Returns: id, customer, campaign_id, checkout_url, currency_code, order_total, tax_total, lines, created_at, updated_at, _links. Required: store_id.

get_single_mailchimp_store_cart_by_id

Get a specific Mailchimp store cart by id. Returns: id, customer, campaign_id, checkout_url, currency_code, order_total, tax_total, lines, created_at, updated_at, _links. Required: store_id, id.

create_a_mailchimp_store_cart

Create a new cart in a Mailchimp store. Returns: id, customer, campaign_id, checkout_url, currency_code, order_total, tax_total, lines, created_at, updated_at, _links, x-title. Required: store_id, id, currency_code, customer, order_total, lines.

mailchimp_store_carts_bulk_update

Update a specific Mailchimp store cart. Returns: id, customer, campaign_id, checkout_url, currency_code, order_total, tax_total, lines, created_at, updated_at, _links. Required: store_id, cart_id.

mailchimp_store_carts_bulk_delete

Delete a Mailchimp store cart by cart_id. Returns an empty 204 response on success. Required: store_id, cart_id.

list_all_mailchimp_store_customers

List Mailchimp store customers. Returns: id, email_address, sms_phone_number, opt_in_status, company, first_name, last_name, orders_count, total_spent, address, created_at, updated_at, _links. Required: store_id. Max 1000 records per page.

get_single_mailchimp_store_customer_by_id

Get a single Mailchimp store customer by id. Returns: id, email_address, sms_phone_number, opt_in_status, company, first_name, last_name, orders_count, total_spent, address, created_at, updated_at, _links. Required: store_id, id.

create_a_mailchimp_store_customer

Add a new customer to a Mailchimp store. Returns: id, email_address, sms_phone_number, opt_in_status, company, first_name, last_name, orders_count, total_spent, address, created_at, updated_at, _links, x-title. Required: store_id, id, opt_in_status. Customer id limited to 50 characters.

mailchimp_store_customers_bulk_update

Add or update (upsert) a Mailchimp store customer by customer_id. Returns: id, email_address, sms_phone_number, opt_in_status, company, first_name, last_name, orders_count, total_spent, address, created_at, updated_at, _links. Required: store_id, customer_id, id.

mailchimp_store_customers_partial_update

Update a Mailchimp store customer by id. Returns: id, email_address, sms_phone_number, opt_in_status, company, first_name, last_name, orders_count, total_spent, address, created_at, updated_at, _links. Required: store_id, id.

mailchimp_store_customers_bulk_delete

Delete a Mailchimp ecommerce store customer from a store. Returns an empty 204 response on success. Required: store_id, customer_id.

list_all_mailchimp_store_promo_rules

List Mailchimp promo rules for a store. Returns: id, title, description, starts_at, ends_at, amount, type, target, enabled, created_at_foreign, updated_at_foreign, _links. Required: store_id. Max 1000 records per page.

get_single_mailchimp_store_promo_rule_by_id

Get a single Mailchimp promo rule by id. Returns: id, title, description, starts_at, ends_at, amount, type, target, enabled, created_at_foreign, updated_at_foreign, _links. Required: store_id, id.

create_a_mailchimp_store_promo_rule

Create a new Mailchimp promo rule for a store. Returns: id, title, description, starts_at, ends_at, amount, type, target, enabled, created_at_foreign, updated_at_foreign, _links, x-title. Required: store_id, id, description, amount, type, target.

mailchimp_store_promo_rules_bulk_update

Update a Mailchimp promo rule for a store. Returns: id, title, description, starts_at, ends_at, amount, type, target, enabled, created_at_foreign, updated_at_foreign, _links. Required: store_id, promo_rule_id.

mailchimp_store_promo_rules_bulk_delete

Delete a Mailchimp promo rule from a store. Returns an empty 204 response on success. Required: store_id, promo_rule_id.

list_all_mailchimp_template_default_contents

Get the editable sections and their default content for a Mailchimp template. Returns: sections, _links, x-title. Required: template_id.

list_all_mailchimp_facebook_ad_ecommerce_product_activities

List Mailchimp Facebook Ads ecommerce product activity for a specific outreach. Returns: title, sku, image_url, total_revenue, total_purchased, currency_code, recommendation_total, recommendation_purchased. Required: outreach_id. Max 1000 records per page.

list_all_mailchimp_facebook_ads

List Facebook ad out reaches in Mailchimp. Returns: id, web_id, name, type, status, show_report, create_time, start_time, updated_at, canceled_at, published_time, has_segment, report_summary, recipients, email_source_name, paused_at, end_time, needs_attention, was_canceled_by_facebook, thumbnail, is_connected, has_audience, has_content, channel, feedback, site, audience, budget, content, _links.…

get_single_mailchimp_facebook_ad_by_id

Get details of a specific Facebook ad outreach in Mailchimp by id. Returns: id, web_id, type, status, show_report, create_time, start_time, updated_at, canceled_at, published_time, has_segment, report_summary, recipients, email_source_name, paused_at, end_time, needs_attention, was_canceled_by_facebook, thumbnail, is_connected, has_audience, has_content, channel, feedback, site, audience, budget,…

list_all_mailchimp_order_lines

List order line items for a Mailchimp ecommerce order. Returns: id, product_id, product_title, product_variant_id, product_variant_title, image_url, quantity, price, discount, _links. Required: store_id, order_id. Max 1000 records per page.

get_single_mailchimp_order_line_by_id

Get a specific Mailchimp order line item by id. Returns: id, product_id, product_title, product_variant_id, product_variant_title, image_url, quantity, price, discount, _links. Required: store_id, order_id, id.

create_a_mailchimp_order_line

Add a new line item to an existing Mailchimp ecommerce order. Returns: id, product_id, product_title, product_variant_id, product_variant_title, image_url, quantity, price, discount, _links, x-title. Required: store_id, order_id, id, product_id, product_variant_id, quantity, price.

mailchimp_order_lines_bulk_update

Update a specific Mailchimp order line item. Returns: id, product_id, product_title, product_variant_id, product_variant_title, image_url, quantity, price, discount, _links. Required: store_id, order_id, line_id.

mailchimp_order_lines_bulk_delete

Delete a specific Mailchimp order line item. Returns an empty 204 response on success. Required: store_id, order_id, line_id.

list_all_mailchimp_pings

Ping the Mailchimp Marketing API as a health check that won't return any account-specific information. Returns: health_status!"). No parameters required.

list_all_mailchimp_product_images

List product images for a specific Mailchimp product in a store. Returns: id, url, variant_ids, _links. Required: store_id, product_id.

get_single_mailchimp_product_image_by_id

Get information about a specific Mailchimp product image. Returns: id, url, variant_ids, _links. Required: store_id, product_id, id.

create_a_mailchimp_product_image

Add a new image to a Mailchimp product. Returns: id, url, variant_ids, _links, x-title. Required: store_id, product_id, id, url.

mailchimp_product_images_bulk_update

Update a Mailchimp product image. Returns: id, url, variant_ids, _links. Required: store_id, product_id, image_id.

mailchimp_product_images_bulk_delete

Delete a Mailchimp product image. Returns an empty 204 response on success. Required: store_id, product_id, image_id.

list_all_mailchimp_product_variants

List Mailchimp product variants for a specific product in a store. Returns: id, title, url, sku, price, inventory_quantity, image_url, backorders, visibility, created_at, updated_at, _links. Required: store_id, product_id.

get_single_mailchimp_product_variant_by_id

Get a single Mailchimp product variant by id. Returns: id, title, url, sku, price, inventory_quantity, image_url, backorders, visibility, created_at, updated_at, _links. Required: store_id, product_id, id.

create_a_mailchimp_product_variant

Add a new Mailchimp product variant to a product. Returns: id, title, url, sku, price, inventory_quantity, image_url, backorders, visibility, created_at, updated_at, _links, x-title. Required: store_id, product_id, id.

mailchimp_product_variants_bulk_update

Add or update (upsert) a Mailchimp product variant by variant_id. Returns: id, title, url, sku, price, inventory_quantity, image_url, backorders, visibility, created_at, updated_at, _links. Required: store_id, product_id, variant_id, id.

mailchimp_product_variants_partial_update

Partially update a Mailchimp product variant by id. Returns: id, title, url, sku, price, inventory_quantity, image_url, backorders, visibility, created_at, updated_at, _links. Required: store_id, product_id, id.

mailchimp_product_variants_bulk_delete

Delete a Mailchimp e-commerce product variant from a specific store and product. Returns an empty 204 response on success. Required: store_id, product_id, variant_id.

list_all_mailchimp_reporting_facebook_ads

List Facebook ad reports in Mailchimp. Returns: id, web_id, name, type, status, show_report, create_time, start_time, updated_at, canceled_at, published_time, has_segment, report_summary, recipients, email_source_name, paused_at, end_time, needs_attention, was_canceled_by_facebook, thumbnail, channel, audience, budget, audience_activity, _links. Sortable by created_at, updated_at, or end_time.

get_single_mailchimp_reporting_facebook_ad_by_id

Get a single Mailchimp Facebook ad report by id. Returns: id, web_id, type, status, show_report, create_time, start_time, updated_at, canceled_at, published_time, has_segment, report_summary, recipients, email_source_name, paused_at, end_time, needs_attention, was_canceled_by_facebook, thumbnail, channel, audience, budget, audience_activity, _links, x-title, name. Required: id.

list_all_mailchimp_reporting_landing_pages

List Mailchimp landing page reports with engagement and ecommerce metrics. Returns: id, name, title, url, published_at, unpublished_at, status, list_id, visits, unique_visits, subscribes, clicks, conversion_rate, timeseries, ecommerce, web_id, list_name, signup_tags, _links. Max 1000 records per page.

get_single_mailchimp_reporting_landing_page_by_id

Get a Mailchimp landing page report by id. Returns: id, title, url, published_at, unpublished_at, status, list_id, visits, unique_visits, subscribes, clicks, conversion_rate, timeseries, ecommerce, web_id, list_name, signup_tags, _links, x-title. Required: id.

list_all_mailchimp_search_campaigns

Search Mailchimp campaigns by query terms. Returns matching results, each containing a campaign object with id, web_id, type, status, create_time, send_time, and emails_sent. Required: query.

list_all_mailchimp_sms_campaign_contents

Get the content for a Mailchimp SMS campaign. Returns: message_body, estimated_segments, merge_fields, media, source, properties, _links, x-title. Required: sms_campaign_id.

mailchimp_sms_campaign_contents_bulk_update

Set the content for a Mailchimp SMS campaign, including the message body and optional media attachments. Returns: message_body, estimated_segments, merge_fields, media, source, properties, _links, fired_at, data. Required: sms_campaign_id, message_body.

list_all_mailchimp_sms_campaigns

List all Mailchimp SMS campaigns in an account. Returns: id, web_id, name, status, channel, list_id, recipient_count, create_time, send_time, updated_at, expire_time, is_send_now, folder_id, segments, excluded_segments, _links.

get_single_mailchimp_sms_campaign_by_id

Get a specific Mailchimp SMS campaign by id. Returns the campaign object including id, web_id, name, status, channel, list_id, recipient_count, create_time, send_time, updated_at, expire_time, is_send_now, folder_id, segments, excluded_segments, and _links. Required: id.

create_a_mailchimp_sms_campaign

Create a new Mailchimp SMS campaign. Returns the created campaign object including id, web_id, name, status, channel, list_id, recipient_count, create_time, send_time, updated_at, expire_time, is_send_now, folder_id, segments, excluded_segments, and _links. Required: name.

update_a_mailchimp_sms_campaign_by_id

Update settings for a specific Mailchimp SMS campaign by id. Returns the updated campaign object including id, web_id, name, status, channel, list_id, recipient_count, create_time, send_time, updated_at, expire_time, is_send_now, folder_id, segments, excluded_segments, and _links. Required: id.

delete_a_mailchimp_sms_campaign_by_id

Delete a Mailchimp SMS campaign by id. Returns an empty 204 response on success. Required: id.

mailchimp_sms_campaigns_send

Send a Mailchimp SMS campaign immediately. Returns an empty 204 response on success. Required: sms_campaign_id.

mailchimp_sms_campaigns_schedule

Schedule a Mailchimp SMS campaign to send at a specific UTC date and time. Returns an empty 204 response on success. Required: sms_campaign_id, schedule_time.

mailchimp_sms_campaigns_cancel_send

Cancel a scheduled or sending Mailchimp SMS campaign. Returns an empty 204 response on success. Required: sms_campaign_id.

list_all_mailchimp_store_orders

List Mailchimp store orders, optionally filtered by customer, campaign, or outreach. Returns each order with id, customer, currency_code, order_total, lines, financial_status, shipping_address, and billing_address. Required: store_id.

get_single_mailchimp_store_order_by_id

Get a single Mailchimp store order by id. Returns the full order object including id, customer, currency_code, order_total, lines, financial_status, shipping_address, and billing_address. Required: store_id, id.

create_a_mailchimp_store_order

Create a new order in a Mailchimp store. Returns the created order with id, customer, currency_code, order_total, lines, and billing/shipping addresses. Required: store_id, id, customer, currency_code, order_total, lines. Passing cancelled_at_foreign will cancel the order being created.

mailchimp_store_orders_bulk_update

Add or update a Mailchimp e-commerce store order. Returns: id, customer, store_id, campaign_id, cart_id, landing_site, financial_status, fulfillment_status, currency_code, order_total, order_url, discount_total, tax_total, shipping_total, tracking_code, processed_at_foreign, cancelled_at_foreign, updated_at_foreign, shipping_address, billing_address, promos, lines, outreach, tracking_number,…

mailchimp_store_orders_partial_update

Update a specific Mailchimp ecommerce order in a store. Returns the updated order object including its id, customer, currency_code, order_total, financial_status, fulfillment_status, and lines. Required: store_id, id.

mailchimp_store_orders_bulk_delete

Delete an order from a Mailchimp ecommerce store. Returns an empty 204 response on success. Required: store_id, order_id.

list_all_mailchimp_store_products

List Mailchimp e-commerce store products. Returns: id, currency_code, title, handle, url, description, type, vendor, image_url, variants, images, published_at_foreign, _links. Required: store_id.

get_single_mailchimp_store_product_by_id

Get a single Mailchimp e-commerce store product by id. Returns: id, currency_code, title, handle, url, description, type, vendor, image_url, variants, images, published_at_foreign, _links. Required: store_id, id.

create_a_mailchimp_store_product

Add a new product to a Mailchimp e-commerce store. Returns: id, currency_code, title, handle, url, description, type, vendor, image_url, variants, images, published_at_foreign, _links, x-title. Required: store_id, id, title, variants.

mailchimp_store_products_bulk_update

Create or update (upsert) a Mailchimp e-commerce store product. Returns: id, currency_code, title, handle, url, description, type, vendor, image_url, variants, images, published_at_foreign, _links. Required: store_id, product_id, id.

mailchimp_store_products_partial_update

Partially update a Mailchimp e-commerce store product. Returns: id, currency_code, title, handle, url, description, type, vendor, image_url, variants, images, published_at_foreign, _links. Required: store_id, id.

mailchimp_store_products_bulk_delete

Delete a product from a Mailchimp ecommerce store. Returns an empty 204 response on success. Required: store_id, product_id.

list_all_mailchimp_question_answers

List answers submitted for a specific Mailchimp survey question. Returns: id, value, response_id, submitted_at, contact, is_new_contact. Required: survey_id, question_id.

get_single_mailchimp_reporting_survey_by_id

Get a Mailchimp survey report by id. Returns: id, web_id, list_id, list_name, title, url, status, published_at, created_at, updated_at, total_responses, x-title. Required: id.

list_all_mailchimp_reporting_surveys

List Mailchimp survey reports. Returns each survey report with id, title, status, total_responses, list_id, list_name, url, web_id, published_at, created_at, and updated_at. Max 1000 records per page.

get_single_mailchimp_survey_question_by_id

Get a single Mailchimp survey question report by id. Returns the question report including its id, survey_id, query, type, total_responses, is_required, options, and contact_counts. Required: survey_id, id.

list_all_mailchimp_survey_questions

List Mailchimp survey question reports for a survey. Returns each question report with id, survey_id, query, type, total_responses, is_required, options, and contact_counts. Required: survey_id.

get_single_mailchimp_survey_response_by_id

Get a single Mailchimp survey response by id. Returns: response_id, submitted_at, contact, is_new_contact, results, fired_at, data. Required: survey_id, id.

list_all_mailchimp_survey_responses

List Mailchimp survey responses for a survey. Returns: response_id, submitted_at, contact, is_new_contact. Required: survey_id.

list_all_mailchimp_verified_domains

List verified domains on the Mailchimp account. Returns: domain, verified, authenticated, verification_email, verification_sent, status, is_free_email_provider.

create_a_mailchimp_verified_domain

Add a domain to the Mailchimp account for verification. Returns: domain, verified, authenticated, verification_email, verification_sent, status, is_free_email_provider. Required: verification_email.

mailchimp_verified_domains_bulk_delete

Delete a verified domain from the Mailchimp account. Returns an empty 204 response on success. Required: domain_name.

mailchimp_verified_domains_verify

Verify a domain for sending in Mailchimp by submitting the verification challenge code. Returns: domain, verified, authenticated, verification_email, verification_sent, status, is_free_email_provider, x-title. Required: domain_name, code.

list_all_mailchimp_verified_domains_verified_domains

Get details for a single verified domain in Mailchimp by domain name. Returns: domain, verified, authenticated, verification_email, verification_sent, status, is_free_email_provider. Required: domain_name.

Why Truto

Why use Truto’s MCP server for Mailchimp

Other MCP servers give you a static tool list for one app. Truto gives you a managed, multi-tenant MCP infrastructure across 650+ integrations.

01

Auto-generated, always up to date

Tools are dynamically generated from curated documentation — not hand-coded. As integrations evolve, tools stay current without manual maintenance.

02

Fine-grained access control

Scope each MCP server to read-only, write-only, specific methods, or tagged tool groups. Expose only what your AI agent needs — nothing more.

03

Multi-tenant by design

Each MCP server is scoped to a single connected account with its own credentials. The URL itself is the auth token — no shared secrets, no credential leaking across tenants.

04

Works with every MCP client

Standard JSON-RPC 2.0 protocol. Paste the URL into Claude, ChatGPT, Cursor, or any MCP-compatible agent framework — tools are discovered automatically.

05

Built-in auth, rate limits, and error handling

Tool calls execute through Truto’s proxy layer with automatic OAuth refresh, rate-limit handling, and normalized error responses. No raw API plumbing in your agent.

06

Expiring and auditable servers

Create time-limited MCP servers for contractors or automated workflows. Optional dual-auth requires both the URL and a Truto API token for high-security environments.

Unified APIs

Unified APIs for Mailchimp

Skip writing code for every integration. Use Truto’s category-specific Unified APIs out of the box or customize the mappings with AI.

Unified Marketing Automation API

Contacts

The contact represent a contact in the remote system.

View Docs

Lists

The list represent a list of contacts in the remote system.

View Docs

Tags

The tags on a contact in the remote system.

View Docs

Users

The user represent a user in the remote system.

View Docs

How It Works

From zero to integrated

Go live with Mailchimp in under an hour. No boilerplate, no maintenance burden.

01

Link your customer’s Mailchimp account

Use Truto’s frontend SDK to connect your customer’s Mailchimp account. We handle all OAuth and API key flows — you don’t need to create the OAuth app.

02

We handle authentication

Don’t spend time refreshing access tokens or figuring out secure storage. We handle it and inject credentials into every API request.

03

Call our API, we call Mailchimp

Truto’s Proxy API is a 1-to-1 mapping of the Mailchimp API. You call us, we call Mailchimp, and pass the response back in the same cycle.

04

Unified response format

Every response follows a single format across all integrations. We translate Mailchimp’s pagination into unified cursor-based pagination. Data is always in the result attribute.

FAQs

Common questions about Mailchimp on Truto

Authentication, rate limits, data freshness, and everything else you need to know before you integrate.

How does authentication work for Mailchimp integrations through Truto?

Mailchimp supports OAuth 2.0. Your end users authorize their Mailchimp account through a standard OAuth flow managed by Truto, so you never handle or store their credentials directly.

What does Truto's Unified Marketing Automation API cover for Mailchimp?

The Unified Marketing Automation API provides standardized access to Contacts (Mailchimp Members), Lists (Mailchimp Audiences), Tags, and Users. This covers the core workflows most SaaS integrations need — listing audiences, upserting contacts, managing tags, and reading user info.

How does Mailchimp handle contact creation vs. updates?

Mailchimp's API supports an upsert pattern using the MD5 hash of the lowercase email address as the identifier. If the contact exists, it updates their merge fields and tags; if not, it creates a new subscriber. This prevents duplicate errors and simplifies sync logic.

Are custom fields (merge fields) supported?

Yes. Mailchimp merge fields — like First Name, Company, or any custom field the user has created — can be read and written. You can fetch available merge fields for a list to build dynamic field mapping UIs in your product.

What are Mailchimp's API rate limits?

Mailchimp enforces a limit of 10 simultaneous connections per user. Truto handles pagination and connection management, but high-volume batch operations should be designed with this concurrency limit in mind.

What if I need Mailchimp capabilities beyond the Unified Marketing Automation API?

Truto builds tools on request. If you need access to additional Mailchimp endpoints — like campaigns, e-commerce data, or automations — you can request them and Truto will extend coverage for your use case.

Mailchimp

Get Mailchimp integrated into your app

Our team understands what it takes to make a Mailchimp integration successful. A short, crisp 30 minute call with folks who understand the problem.