The API root resource links to all other resources available in the API. Calling the root directory also returns details about the Mailchimp user account.
Manage registered, connected apps for your Mailchimp account with the Authorized Apps endpoints.
Mailchimp's classic automations feature lets you build a series of emails that send to subscribers when triggered by a specific date, activity, or event. Use the API to manage Automation workflows, emails, and queues. Does not include Customer Journeys.
Manage individual emails in a classic automation workflow.
Manage list member queues for classic automation emails.
Remove subscribers from a classic automation workflow.
Use batch operations to complete multiple operations with a single call.
Manage webhooks for batch operations.
Organize your campaigns using folders.
Campaigns are how you send emails to your Mailchimp list. Use the Campaigns API calls to manage campaigns in your Mailchimp account.
Manage the HTML, plain-text, and template content for your Mailchimp campaigns.
Post comments, reply to team feedback, and send test emails while you're working together on a Mailchimp campaign.
Review the send checklist for your campaign, and resolve any issues before sending.
Chimp Chatter Activity
Get the latest Chimp Chatter activity from your account.
Manage sites you've connected to your Mailchimp account.
Conversation tracking lets you view subscribers' replies to your campaigns in your Mailchimp account.
Manage messages in a specific campaign conversation.
Manage Customer Journey automated workflows
Connect your E-commerce Store to Mailchimp to take advantage of powerful reporting and personalization features and to learn more about your customers.
Each Cart contains one or more Cart Lines, which represent a specific Product Variant that a Customer has added to their shopping cart.
Use Carts to represent unfinished e-commerce transactions. This can be used to create an Abandoned Cart workflow, or to save a consumer’s shopping cart pending a successful Order.
Add Customers to your Store to track their orders and to view E-Commerce Data for your Mailchimp lists and campaigns. Each Customer is connected to a Mailchimp list member, so adding a Customer can also add or update a list member.
Each Order contains one or more Order Lines, which represent a specific Product Variant that a Customer purchases.
Orders represent successful e-commerce transactions, and this data can be used to provide more detailed campaign reports, track sales, and personalize emails to your targeted consumers, and view other e-commerce data in your Mailchimp account.
A Product Image represents a specific product image.
A Product Variant represents a specific item for purchase, and is contained within a parent Product. At least one Product Variant is required for each Product.
E-commerce items for sale in your store need to be created as Products so you can add the items to a Cart or an Order. Each Product requires at least one Product Variant.
Promo codes can be created for a given price rule. All the promo codes under a price rule share the generic information defined for that rule like the amount, type, expiration date etc. Promo code defines the more specific information about a promo code like the actual code, redemption_url, usage_count, etc that's unique to a code. Promo Code must be defined under a promo rule.
Promo Rules help you create promo codes for your campaigns. Promo Rules define generic information about promo codes like expiration time, start time, amount of discount being offered etc. For a given promo rule you can define if it's a percentage discount or a fixed amount and if it applies for the order as a whole or if it's per item or free shipping. You can then create promo codes for this price rule. Promo codes contain the actual code that is applied at checkout along with some other information. Price Rules have one to many relationship with promo codes.
Get information about Facebook Ads.
Manage files for your Mailchimp account. The File Manager is a place to store images, documents, and other files you include or link to in your campaigns, templates, or signup forms.
File Manager Files
Manage specific files in the File Manager for your Mailchimp account.
File Manager Folders
Manage specific folders in the File Manager for your Mailchimp account.
Manage your Landing Pages, including publishing and unpublishing.
The HTML content for your Mailchimp landing pages.
Your Mailchimp list, also known as your audience, is where you store and manage all of your contacts.
Manage abuse complaints for a specific list. An abuse complaint occurs when your recipient reports an email as spam in their mail program.
Get recent daily, aggregated activity stats for your list. For example, view unsubscribes, signups, total emails sent, opens, clicks, and more, for up to 180 days.
Get information about the most popular email clients for subscribers in a specific Mailchimp list.
Use the Events endpoint to collect website or in-app actions and trigger targeted automations.
View a summary of the month-by-month growth activity for a specific list.
Manage interest categories for a specific list. Interest categories organize interests, which are used to group subscribers based on their preferences. These correspond to 'group titles' in the Mailchimp application.
Manage interests for a specific Mailchimp list. Assign subscribers to interests to group them together. Interests are referred to as 'group names' in the Mailchimp application.
Get the locations (countries) that the list's subscribers have been tagged to based on geocoding their IP address.
Get details about a subscriber's recent activity. Use the new activity-feed endpoint to access more events for a given contact.
Member Activity Feed
Get details about a subscriber's recent activity.
Get information about recent goal events for a specific list member.
Retrieve recent notes for a specific list member.
Manage all the tags that have been assigned to a contact.
Manage members of a specific Mailchimp list, including currently subscribed, unsubscribed, and bounced members.
Manage merge fields (formerly merge vars) for a specific list.
Manage list members in a saved segment.
Manage segments and tags for a specific Mailchimp list. A segment is a section of your list that includes only those subscribers who share specific common field information. Tags are labels you create to help organize your contacts.
Manage list signup forms.
Search for tags on a list by name.
Manage webhooks for a specific Mailchimp list.
A health check endpoint for Mailchimp API 3.0.
Reporting for various campaign types.
Get information about Facebook Ad reports.
Get information about Landing Page reports.
Manage campaign reports for your Mailchimp account. All Reports endpoints are read-only. Mailchimp's campaign and automation reports analyze clicks, opens, subscribers' social activity, e-commerce data, and more. Note: Campaign IDs for A/B Testing Campaigns are available through the Campaign API Endpoint's Read method.
Get information about campaign abuse complaints.
Get recent feedback based on a campaign's statistics.
Campaign Open Reports
Get a detailed report about any emails in a specific campaign that were opened by the recipient.
Get detailed information about links clicked in campaigns.
Click Reports Members
Get information about specific subscribers who clicked on links in a campaign.
Get statistics for the top-performing domains from a campaign.
Ecommerce Product Activity
Ecommerce product activity report for a campaign.
Get a summary of social activity for the campaign, tracked by EepURL.
Get list member activity for a specific campaign.
Get top open locations for a specific campaign.
Get details about campaign recipients.
A list of reports for child campaigns of a specific parent campaign. For example, use this endpoint to view Multivariate, RSS, and A/B Testing Campaign reports.
Get information about list members who unsubscribed from a specific campaign.
Search all of an account's campaigns for the specified query terms.
Search the account or a specific list for members that match the specified query terms.
Organize your templates using folders.
Manage your Mailchimp templates. A template is an HTML file used to create the layout and basic design for a campaign.
Manage the default content for a Mailchimp template.
Manage the domains on your account that can be used for sending email campaigns.