Mailchimp Developer LogoMailchimp Developer Wordmark

Marketing API

  • API Root

    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.

    Improve our docs onGitHub
    • Account Exports

      Generate a new export or download a finished export.

      Improve our docs onGitHub
      • Authorized Apps

        Manage registered, connected apps for your Mailchimp account with the Authorized Apps endpoints.

        Improve our docs onGitHub
        • Automations

          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.

          Improve our docs onGitHub
          • Automations

            Emails

            Manage individual emails in a classic automation workflow.

            Improve our docs onGitHub
          • Automations

            Queue

            Manage list member queues for classic automation emails.

            Improve our docs onGitHub
          • Automations

            Removed Subscribers

            Remove subscribers from a classic automation workflow.

            Improve our docs onGitHub
        • Batch Operations

          Use batch operations to complete multiple operations with a single call.

          Improve our docs onGitHub
          • Batch Webhooks

            Manage webhooks for batch operations.

            Improve our docs onGitHub
            • Campaign Folders

              Organize your campaigns using folders.

              Improve our docs onGitHub
              • Campaigns

                Campaigns are how you send emails to your Mailchimp list. Use the Campaigns API calls to manage campaigns in your Mailchimp account.

                Improve our docs onGitHub
                • Campaigns

                  Content

                  Manage the HTML, plain-text, and template content for your Mailchimp campaigns.

                  Improve our docs onGitHub
                • Campaigns

                  Feedback

                  Post comments, reply to team feedback, and send test emails while you're working together on a Mailchimp campaign.

                  Improve our docs onGitHub
                • Campaigns

                  Send Checklist

                  Review the send checklist for your campaign, and resolve any issues before sending.

                  Improve our docs onGitHub
              • Chimp Chatter Activity

                Get the latest Chimp Chatter activity from your account.

                Improve our docs onGitHub
                • Connected Sites

                  Manage sites you've connected to your Mailchimp account.

                  Improve our docs onGitHub
                  • Conversations

                    Conversation tracking lets you view subscribers' replies to your campaigns in your Mailchimp account.

                    Improve our docs onGitHub
                    • Conversations

                      Messages

                      Manage messages in a specific campaign conversation.

                      Improve our docs onGitHub
                  • Customer Journeys

                    Manage Customer Journey automated workflows

                    Improve our docs onGitHub
                    • E-commerce Stores

                      Connect your E-commerce Store to Mailchimp to take advantage of powerful reporting and personalization features and to learn more about your customers.

                      Improve our docs onGitHub
                      • E-commerce Stores

                        Cart Lines

                        Each Cart contains one or more Cart Lines, which represent a specific Product Variant that a Customer has added to their shopping cart.

                        Improve our docs onGitHub
                      • E-commerce Stores

                        Carts

                        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.

                        Improve our docs onGitHub
                      • E-commerce Stores

                        Customers

                        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.

                        Improve our docs onGitHub
                      • E-commerce Stores

                        Order Lines

                        Each Order contains one or more Order Lines, which represent a specific Product Variant that a Customer purchases.

                        Improve our docs onGitHub
                      • E-commerce Stores

                        Orders

                        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.

                        Improve our docs onGitHub
                      • E-commerce Stores

                        Product Images

                        A Product Image represents a specific product image.

                        Improve our docs onGitHub
                      • E-commerce Stores

                        Product Variants

                        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.

                        Improve our docs onGitHub
                      • E-commerce Stores

                        Products

                        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.

                        Improve our docs onGitHub
                      • E-commerce Stores

                        Promo Codes

                        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.

                        Improve our docs onGitHub
                      • E-commerce Stores

                        Promo Rules

                        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.

                        Improve our docs onGitHub
                    • Facebook Ads

                      Get information about Facebook Ads.

                      Improve our docs onGitHub
                      • File Manager

                        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.

                          Improve our docs onGitHub
                          • File Manager

                            File Manager Files

                            Manage specific files in the File Manager for your Mailchimp account.

                            Improve our docs onGitHub
                          • File Manager

                            File Manager Folders

                            Manage specific folders in the File Manager for your Mailchimp account.

                            Improve our docs onGitHub
                        • Landing Pages

                          Manage your Landing Pages, including publishing and unpublishing.

                          Improve our docs onGitHub
                          • Landing Pages

                            Content

                            The HTML content for your Mailchimp landing pages.

                            Improve our docs onGitHub
                        • Lists/Audiences

                          Your Mailchimp list, also known as your audience, is where you store and manage all of your contacts.

                          Improve our docs onGitHub
                          • Lists/Audiences

                            Abuse Reports

                            Manage abuse complaints for a specific list. An abuse complaint occurs when your recipient reports an email as spam in their mail program.

                            Improve our docs onGitHub
                          • Lists/Audiences

                            Activity

                            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.

                            Improve our docs onGitHub
                          • Lists/Audiences

                            Clients

                            Get information about the most popular email clients for subscribers in a specific Mailchimp list.

                            Improve our docs onGitHub
                          • Lists/Audiences

                            Events

                            Use the Events endpoint to collect website or in-app actions and trigger targeted automations.

                            Improve our docs onGitHub
                          • Lists/Audiences

                            Growth History

                            View a summary of the month-by-month growth activity for a specific list.

                            Improve our docs onGitHub
                          • Lists/Audiences

                            Interest Categories

                            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.

                            Improve our docs onGitHub
                          • Lists/Audiences

                            Interests

                            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.

                            Improve our docs onGitHub
                          • Lists/Audiences

                            Locations

                            Get the locations (countries) that the list's subscribers have been tagged to based on geocoding their IP address.

                            Improve our docs onGitHub
                          • Lists/Audiences

                            Member Activity

                            Get details about a subscriber's recent activity. Use the new activity-feed endpoint to access more events for a given contact.

                            Improve our docs onGitHub
                          • Lists/Audiences

                            Member Activity Feed

                            Get details about a subscriber's recent activity.

                            Improve our docs onGitHub
                          • Lists/Audiences

                            Member Goals

                            Get information about recent goal events for a specific list member.

                            Improve our docs onGitHub
                          • Lists/Audiences

                            Member Notes

                            Retrieve recent notes for a specific list member.

                            Improve our docs onGitHub
                          • Lists/Audiences

                            Member Tags

                            Manage all the tags that have been assigned to a contact.

                            Improve our docs onGitHub
                          • Lists/Audiences

                            Members

                            Manage members of a specific Mailchimp list, including currently subscribed, unsubscribed, and bounced members.

                            Improve our docs onGitHub
                          • Lists/Audiences

                            Merge Fields

                            Manage merge fields (audience fields) for a specific list.

                            Improve our docs onGitHub
                          • Lists/Audiences

                            Segment Members

                            Manage list members in a saved segment.

                            Improve our docs onGitHub
                          • Lists/Audiences

                            Segments

                            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.

                            Improve our docs onGitHub
                          • Lists/Audiences

                            Signup Forms

                            Manage list signup forms.

                            Improve our docs onGitHub
                          • Lists/Audiences

                            Tag Search

                            Search for tags on a list by name.

                            Improve our docs onGitHub
                          • Lists/Audiences

                            Webhooks

                            Manage webhooks for a specific Mailchimp list.

                            Improve our docs onGitHub
                        • Ping

                          A health check endpoint for Mailchimp API 3.0.

                          Improve our docs onGitHub
                          • Reporting

                            Reporting for various campaign types.

                              Improve our docs onGitHub
                              • Reporting

                                Facebook Ads

                                Get information about Facebook Ad reports.

                                Improve our docs onGitHub
                              • Reporting

                                Landing Pages

                                Get information about Landing Page reports.

                                Improve our docs onGitHub
                            • 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.

                              Improve our docs onGitHub
                              • Reports

                                Campaign Abuse

                                Get information about campaign abuse complaints.

                                Improve our docs onGitHub
                              • Reports

                                Campaign Advice

                                Get recent feedback based on a campaign's statistics.

                                Improve our docs onGitHub
                              • Reports

                                Campaign Open Reports

                                Get a detailed report about any emails in a specific campaign that were opened by the recipient.

                                Improve our docs onGitHub
                              • Reports

                                Click Reports

                                Get detailed information about links clicked in campaigns.

                                Improve our docs onGitHub
                              • Reports

                                Click Reports Members

                                Get information about specific subscribers who clicked on links in a campaign.

                                Improve our docs onGitHub
                              • Reports

                                Domain Performance

                                Get statistics for the top-performing domains from a campaign.

                                Improve our docs onGitHub
                              • Reports

                                Ecommerce Product Activity

                                Ecommerce product activity report for a campaign.

                                Improve our docs onGitHub
                              • Reports

                                EepURL Reports

                                Get a summary of social activity for the campaign, tracked by EepURL.

                                Improve our docs onGitHub
                              • Reports

                                Email Activity

                                Get list member activity for a specific campaign.

                                Improve our docs onGitHub
                              • Reports

                                Location

                                Get top open locations for a specific campaign.

                                Improve our docs onGitHub
                              • Reports

                                Sent To

                                Get details about campaign recipients.

                                Improve our docs onGitHub
                              • Reports

                                Sub-Reports

                                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.

                                Improve our docs onGitHub
                              • Reports

                                Unsubscribes

                                Get information about list members who unsubscribed from a specific campaign.

                                Improve our docs onGitHub
                            • Search Campaigns

                              Search all of an account's campaigns for the specified query terms.

                              Improve our docs onGitHub
                              • Search Members

                                Search the account or a specific list for members that match the specified query terms.

                                Improve our docs onGitHub
                                • Template Folders

                                  Organize your templates using folders.

                                  Improve our docs onGitHub
                                  • Templates

                                    Manage your Mailchimp templates. A template is an HTML file used to create the layout and basic design for a campaign.

                                    Improve our docs onGitHub
                                    • Templates

                                      Default Content

                                      Manage the default content for a Mailchimp template.

                                      Improve our docs onGitHub
                                  • Verified Domains

                                    Manage the domains on your account that can be used for sending email campaigns.

                                    Improve our docs onGitHub