> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://mailchimp.com/developer/marketing/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://mailchimp.com/_mcp/server. # Mailchimp Marketing API > Find all the Mailchimp API documentation and tools developers need to send marketing and transactional emails. ## Docs - [How Mailchimp works](https://mailchimp.com/developer/marketing/concepts/how-mailchimp-works.md): What Mailchimp does for the businesses that use it, and what people use the Marketing API to do. - [Audiences](https://mailchimp.com/developer/marketing/concepts/audiences.md): How audiences, contacts, tags, merge fields, and segments relate to each other in Mailchimp. - [Contacts](https://mailchimp.com/developer/marketing/concepts/audiences/contacts.md): The contact model, subscription status across channels, and how tags organize contacts. - [Merge fields](https://mailchimp.com/developer/marketing/concepts/audiences/merge-fields.md): Save and retrieve custom contact data to personalize campaigns. - [Segments](https://mailchimp.com/developer/marketing/concepts/audiences/segments.md): Subsets of contacts in an audience, defined by their attributes, activity, or tags. - [E-Commerce](https://mailchimp.com/developer/marketing/concepts/e-commerce.md): How stores, customers, products, carts, and orders relate to each other in Mailchimp. - [API structure](https://mailchimp.com/developer/marketing/api-concepts/api-structure.md): How the Marketing API is organized—REST conventions and the root URL. - [Authentication](https://mailchimp.com/developer/marketing/api-concepts/authentication.md): Choose between an API key and an OAuth 2 access token, then attach it to a request. - [API keys](https://mailchimp.com/developer/marketing/api-concepts/authentication/api-keys.md): How Mailchimp API keys behave, and where they can and cannot be used. - [OAuth 2](https://mailchimp.com/developer/marketing/api-concepts/authentication/oauth-2.md): How Mailchimp's OAuth 2 flow works, and what your application gets from it. - [Methods and parameters](https://mailchimp.com/developer/marketing/api-concepts/methods-and-parameters.md): Get to know some of the conventions of the Marketing API. - [Rate limits and timeouts](https://mailchimp.com/developer/marketing/api-concepts/rate-limits-and-timeouts.md): Connection limits, throttling, and the 120-second timeout on Marketing API calls. - [Errors](https://mailchimp.com/developer/marketing/api-concepts/errors.md): A glossary of Marketing API errors and how to troubleshoot them. - [Webhooks](https://mailchimp.com/developer/marketing/api-concepts/webhooks.md): Keep your data store in sync with your Mailchimp audience via webhooks. - [Batch operations](https://mailchimp.com/developer/marketing/api-concepts/batch-operations.md): Scale large or long-running calls to the Marketing API with batch requests. - [Alternative schemas](https://mailchimp.com/developer/marketing/api-concepts/alternative-schemas.md): Details about Marketing API endpoints that accept or return multiple types of data. - [Audiences endpoints (beta)](https://mailchimp.com/developer/marketing/api-concepts/audiences-endpoints-beta.md): Learn about the new audiences endpoints and the concepts they're introducing. - [Create an account](https://mailchimp.com/developer/marketing/build/get-started/create-an-account.md): Create a Mailchimp account and understand how your plan level affects API access. - [Generate your API key](https://mailchimp.com/developer/marketing/build/get-started/generate-your-api-key.md): Create an API key in your Mailchimp account and store it securely. - [Import and export contacts](https://mailchimp.com/developer/marketing/build/quickstarts/import-and-export-contacts.md): Import contacts into an existing audience and read them back out, including bulk operations. - [Organize contacts with tags](https://mailchimp.com/developer/marketing/build/quickstarts/organize-contacts-with-tags.md): Use tags to bring your application\u2019s email targeting and organization strategy into Mailchimp. - [Client libraries and SDKs](https://mailchimp.com/developer/marketing/build/start-developing/client-libraries-and-sdks.md): Official client libraries for the Mailchimp Marketing API, plus the Mobile SDK for iOS and Android. - [Send your first API request](https://mailchimp.com/developer/marketing/build/start-developing/send-your-first-api-request.md): Make your first call to the Marketing API and verify your credentials with the Ping endpoint. - [CLI](https://mailchimp.com/developer/marketing/build/start-developing/cli.md): Install and use the Mailchimp CLI to call the Marketing API from your terminal. - [Set up an OAuth app](https://mailchimp.com/developer/marketing/build/start-developing/set-up-an-oauth-app.md): Register an application, implement the OAuth 2 flow on your server, and rotate a client secret. - [Overview](https://mailchimp.com/developer/marketing/build/ai-tools.md): How AI agents and assistants work with the Mailchimp Marketing API. - [MCP server](https://mailchimp.com/developer/marketing/build/ai-tools/mcp-server.md): Query these docs from an AI agent through the Model Context Protocol. - [Agent skills](https://mailchimp.com/developer/marketing/build/ai-tools/agent-skills.md): Install Mailchimp's agent skills so your coding agent calls the Marketing API correctly. - [llms.txt](https://mailchimp.com/developer/marketing/build/ai-tools/llms-txt.md): Machine-readable documentation index for LLMs and AI coding tools. - [Contacts](https://mailchimp.com/developer/marketing/api/audiences/contacts.md) ## API Docs - API Reference > Root [List API root resources](https://mailchimp.com/developer/marketing/api/root/list.md) - API Reference > Account Exports [List account exports](https://mailchimp.com/developer/marketing/api/account-exports/list.md) - API Reference > Account Exports [Add export](https://mailchimp.com/developer/marketing/api/account-exports/create.md) - API Reference > Account Exports [Get account export info](https://mailchimp.com/developer/marketing/api/account-exports/get.md) - API Reference > Activity Feed [List activity feed resources](https://mailchimp.com/developer/marketing/api/activity-feed/list.md) - API Reference > Activity Feed [Get latest chimp chatter](https://mailchimp.com/developer/marketing/api/activity-feed/list-chimp-chatter.md) - API Reference > Audiences > Contacts [A collection of Audience Contacts](https://mailchimp.com/developer/marketing/api/audiences/contacts/get-audience-contact-list.md) - API Reference > Audiences > Contacts [Add Contact](https://mailchimp.com/developer/marketing/api/audiences/contacts/create-audience-contact.md) - API Reference > Audiences > Contacts [Get a contact record](https://mailchimp.com/developer/marketing/api/audiences/contacts/get-audience-contact.md) - API Reference > Audiences > Contacts [Update Contact](https://mailchimp.com/developer/marketing/api/audiences/contacts/patch-audience-contact.md) - API Reference > Audiences > Contacts [Archive Contact](https://mailchimp.com/developer/marketing/api/audiences/contacts/post-audiences-contacts-actions-archive.md) - API Reference > Audiences > Contacts [Forget Contact](https://mailchimp.com/developer/marketing/api/audiences/contacts/post-audiences-contacts-actions-forget.md) - API Reference > Authorized Apps [List authorized apps](https://mailchimp.com/developer/marketing/api/authorized-apps/list.md) - API Reference > Authorized Apps [Get authorized app info](https://mailchimp.com/developer/marketing/api/authorized-apps/get.md) - API Reference > Automations [List automations](https://mailchimp.com/developer/marketing/api/automations/list.md) - API Reference > Automations [Add automation](https://mailchimp.com/developer/marketing/api/automations/create.md) - API Reference > Automations [Get automation info](https://mailchimp.com/developer/marketing/api/automations/get.md) - API Reference > Automations [Archive automation](https://mailchimp.com/developer/marketing/api/automations/create-action-archive.md) - API Reference > Automations [Pause automation emails](https://mailchimp.com/developer/marketing/api/automations/create-action-pause-all-email.md) - API Reference > Automations [Start automation emails](https://mailchimp.com/developer/marketing/api/automations/create-action-start-all-email.md) - API Reference > Automations > Emails [List automated emails](https://mailchimp.com/developer/marketing/api/automations/emails/list-emails.md) - API Reference > Automations > Emails [Get workflow email info](https://mailchimp.com/developer/marketing/api/automations/emails/get-email.md) - API Reference > Automations > Emails [Update workflow email](https://mailchimp.com/developer/marketing/api/automations/emails/update-email.md) - API Reference > Automations > Emails [Delete workflow email](https://mailchimp.com/developer/marketing/api/automations/emails/delete-email.md) - API Reference > Automations > Emails [Pause automated email](https://mailchimp.com/developer/marketing/api/automations/emails/create-email-action-pause.md) - API Reference > Automations > Emails [Start automated email](https://mailchimp.com/developer/marketing/api/automations/emails/create-email-action-start.md) - API Reference > Automations > Emails > Queue [List automated email subscribers](https://mailchimp.com/developer/marketing/api/automations/emails/queue/list-email-queue.md) - API Reference > Automations > Emails > Queue [Add subscriber to workflow email](https://mailchimp.com/developer/marketing/api/automations/emails/queue/create-email-queue.md) - API Reference > Automations > Emails > Queue [Get automated email subscriber](https://mailchimp.com/developer/marketing/api/automations/emails/queue/get-email-queue.md) - API Reference > Automations > Removed subscribers [List subscribers removed from workflow](https://mailchimp.com/developer/marketing/api/automations/removed-subscribers/list-removed-subscribers.md) - API Reference > Automations > Removed subscribers [Remove subscriber from workflow](https://mailchimp.com/developer/marketing/api/automations/removed-subscribers/create-removed-subscriber.md) - API Reference > Automations > Removed subscribers [Get subscriber removed from workflow](https://mailchimp.com/developer/marketing/api/automations/removed-subscribers/get-removed-subscriber.md) - API Reference > Batch Webhooks [List batch webhooks](https://mailchimp.com/developer/marketing/api/batch-webhooks/list.md) - API Reference > Batch Webhooks [Add batch webhook](https://mailchimp.com/developer/marketing/api/batch-webhooks/create.md) - API Reference > Batch Webhooks [Get batch webhook info](https://mailchimp.com/developer/marketing/api/batch-webhooks/get.md) - API Reference > Batch Webhooks [Delete batch webhook](https://mailchimp.com/developer/marketing/api/batch-webhooks/delete.md) - API Reference > Batch Webhooks [Update batch webhook](https://mailchimp.com/developer/marketing/api/batch-webhooks/update.md) - API Reference > Batches [List batch requests](https://mailchimp.com/developer/marketing/api/batches/list.md) - API Reference > Batches [Start batch operation](https://mailchimp.com/developer/marketing/api/batches/create.md) - API Reference > Batches [Get batch operation status](https://mailchimp.com/developer/marketing/api/batches/get.md) - API Reference > Batches [Delete batch request](https://mailchimp.com/developer/marketing/api/batches/delete.md) - API Reference > Campaign Folders [List campaign folders](https://mailchimp.com/developer/marketing/api/campaign-folders/list.md) - API Reference > Campaign Folders [Add campaign folder](https://mailchimp.com/developer/marketing/api/campaign-folders/create.md) - API Reference > Campaign Folders [Get campaign folder](https://mailchimp.com/developer/marketing/api/campaign-folders/get.md) - API Reference > Campaign Folders [Delete campaign folder](https://mailchimp.com/developer/marketing/api/campaign-folders/delete.md) - API Reference > Campaign Folders [Update campaign folder](https://mailchimp.com/developer/marketing/api/campaign-folders/update.md) - API Reference > Campaigns [List campaigns](https://mailchimp.com/developer/marketing/api/campaigns/list.md) - API Reference > Campaigns [Add campaign](https://mailchimp.com/developer/marketing/api/campaigns/create.md) - API Reference > Campaigns [Get campaign info](https://mailchimp.com/developer/marketing/api/campaigns/get.md) - API Reference > Campaigns [Update campaign settings](https://mailchimp.com/developer/marketing/api/campaigns/update.md) - API Reference > Campaigns [Delete campaign](https://mailchimp.com/developer/marketing/api/campaigns/delete.md) - API Reference > Campaigns [Cancel campaign](https://mailchimp.com/developer/marketing/api/campaigns/create-action-cancel-send.md) - API Reference > Campaigns [Resend campaign](https://mailchimp.com/developer/marketing/api/campaigns/create-action-create-resend.md) - API Reference > Campaigns [Pause rss campaign](https://mailchimp.com/developer/marketing/api/campaigns/create-action-pause.md) - API Reference > Campaigns [Replicate campaign](https://mailchimp.com/developer/marketing/api/campaigns/create-action-replicate.md) - API Reference > Campaigns [Resume rss campaign](https://mailchimp.com/developer/marketing/api/campaigns/create-action-resume.md) - API Reference > Campaigns [Schedule campaign](https://mailchimp.com/developer/marketing/api/campaigns/create-action-schedule.md) - API Reference > Campaigns [Send campaign](https://mailchimp.com/developer/marketing/api/campaigns/create-action-send.md) - API Reference > Campaigns [Send test email](https://mailchimp.com/developer/marketing/api/campaigns/create-action-test.md) - API Reference > Campaigns [Unschedule campaign](https://mailchimp.com/developer/marketing/api/campaigns/create-action-unschedule.md) - API Reference > Campaigns [Get campaign content](https://mailchimp.com/developer/marketing/api/campaigns/get-content.md) - API Reference > Campaigns [Set campaign content](https://mailchimp.com/developer/marketing/api/campaigns/upsert-content.md) - API Reference > Campaigns [Get campaign send checklist](https://mailchimp.com/developer/marketing/api/campaigns/list-send-checklist.md) - API Reference > Campaigns > Feedback [List campaign feedback](https://mailchimp.com/developer/marketing/api/campaigns/feedback/list-feedback.md) - API Reference > Campaigns > Feedback [Add campaign feedback](https://mailchimp.com/developer/marketing/api/campaigns/feedback/create-feedback.md) - API Reference > Campaigns > Feedback [Get campaign feedback message](https://mailchimp.com/developer/marketing/api/campaigns/feedback/get-feedback.md) - API Reference > Campaigns > Feedback [Update campaign feedback message](https://mailchimp.com/developer/marketing/api/campaigns/feedback/update-feedback.md) - API Reference > Campaigns > Feedback [Delete campaign feedback message](https://mailchimp.com/developer/marketing/api/campaigns/feedback/delete-feedback.md) - API Reference > Connected Sites [List connected sites](https://mailchimp.com/developer/marketing/api/connected-sites/list.md) - API Reference > Connected Sites [Add connected site](https://mailchimp.com/developer/marketing/api/connected-sites/create.md) - API Reference > Connected Sites [Get connected site](https://mailchimp.com/developer/marketing/api/connected-sites/get.md) - API Reference > Connected Sites [Delete connected site](https://mailchimp.com/developer/marketing/api/connected-sites/delete.md) - API Reference > Connected Sites [Verify connected site script](https://mailchimp.com/developer/marketing/api/connected-sites/create-action-verify-script-installation.md) - API Reference > Conversations [List conversations](https://mailchimp.com/developer/marketing/api/conversations/list.md) - API Reference > Conversations [Get conversation](https://mailchimp.com/developer/marketing/api/conversations/get.md) - API Reference > Conversations [List messages](https://mailchimp.com/developer/marketing/api/conversations/list-messages.md) - API Reference > Conversations [Get message](https://mailchimp.com/developer/marketing/api/conversations/get-message.md) - API Reference > Customer Journeys [Automation flows API trigger for a contact](https://mailchimp.com/developer/marketing/api/customer-journeys/create-journey-step-action-trigger.md) - API Reference > E-commerce [List e-commerce api resources](https://mailchimp.com/developer/marketing/api/e-commerce/list.md) - API Reference > E-commerce [List account orders](https://mailchimp.com/developer/marketing/api/e-commerce/list-orders.md) - API Reference > E-commerce [List stores](https://mailchimp.com/developer/marketing/api/e-commerce/list-stores.md) - API Reference > E-commerce [Add store](https://mailchimp.com/developer/marketing/api/e-commerce/create-store.md) - API Reference > E-commerce [Get store info](https://mailchimp.com/developer/marketing/api/e-commerce/get-store.md) - API Reference > E-commerce [Update store](https://mailchimp.com/developer/marketing/api/e-commerce/update-store.md) - API Reference > E-commerce [Delete store](https://mailchimp.com/developer/marketing/api/e-commerce/delete-store.md) - API Reference > E-commerce > Carts [List carts](https://mailchimp.com/developer/marketing/api/e-commerce/carts/list-store-carts.md) - API Reference > E-commerce > Carts [Add cart](https://mailchimp.com/developer/marketing/api/e-commerce/carts/create-store-cart.md) - API Reference > E-commerce > Carts [Get cart info](https://mailchimp.com/developer/marketing/api/e-commerce/carts/get-store-cart.md) - API Reference > E-commerce > Carts [Update cart](https://mailchimp.com/developer/marketing/api/e-commerce/carts/update-store-cart.md) - API Reference > E-commerce > Carts [Delete cart](https://mailchimp.com/developer/marketing/api/e-commerce/carts/delete-store-cart.md) - API Reference > E-commerce > Carts [List cart line items](https://mailchimp.com/developer/marketing/api/e-commerce/carts/list-store-cart-lines.md) - API Reference > E-commerce > Carts [Add cart line item](https://mailchimp.com/developer/marketing/api/e-commerce/carts/create-store-cart-line.md) - API Reference > E-commerce > Carts [Get cart line item](https://mailchimp.com/developer/marketing/api/e-commerce/carts/get-store-cart-line.md) - API Reference > E-commerce > Carts [Update cart line item](https://mailchimp.com/developer/marketing/api/e-commerce/carts/update-store-cart-line.md) - API Reference > E-commerce > Carts [Delete cart line item](https://mailchimp.com/developer/marketing/api/e-commerce/carts/delete-store-cart-line.md) - API Reference > E-commerce > Customers [List customers](https://mailchimp.com/developer/marketing/api/e-commerce/customers/list-store-customers.md) - API Reference > E-commerce > Customers [Add customer](https://mailchimp.com/developer/marketing/api/e-commerce/customers/create-store-customer.md) - API Reference > E-commerce > Customers [Get customer info](https://mailchimp.com/developer/marketing/api/e-commerce/customers/get-store-customer.md) - API Reference > E-commerce > Customers [Update customer](https://mailchimp.com/developer/marketing/api/e-commerce/customers/update-store-customer.md) - API Reference > E-commerce > Customers [Add or update customer](https://mailchimp.com/developer/marketing/api/e-commerce/customers/upsert-store-customer.md) - API Reference > E-commerce > Customers [Delete customer](https://mailchimp.com/developer/marketing/api/e-commerce/customers/delete-store-customer.md) - API Reference > E-commerce > Orders [List orders](https://mailchimp.com/developer/marketing/api/e-commerce/orders/list-store-orders.md) - API Reference > E-commerce > Orders [Add order](https://mailchimp.com/developer/marketing/api/e-commerce/orders/create-store-order.md) - API Reference > E-commerce > Orders [Get order info](https://mailchimp.com/developer/marketing/api/e-commerce/orders/get-store-order.md) - API Reference > E-commerce > Orders [Update order](https://mailchimp.com/developer/marketing/api/e-commerce/orders/update-store-order.md) - API Reference > E-commerce > Orders [Delete order](https://mailchimp.com/developer/marketing/api/e-commerce/orders/delete-store-order.md) - API Reference > E-commerce > Orders [List order line items](https://mailchimp.com/developer/marketing/api/e-commerce/orders/list-store-order-lines.md) - API Reference > E-commerce > Orders [Add order line item](https://mailchimp.com/developer/marketing/api/e-commerce/orders/create-store-order-line.md) - API Reference > E-commerce > Orders [Get order line item](https://mailchimp.com/developer/marketing/api/e-commerce/orders/get-store-order-line.md) - API Reference > E-commerce > Orders [Update order line item](https://mailchimp.com/developer/marketing/api/e-commerce/orders/update-store-order-line.md) - API Reference > E-commerce > Orders [Delete order line item](https://mailchimp.com/developer/marketing/api/e-commerce/orders/delete-store-order-line.md) - API Reference > E-commerce > Products [List product](https://mailchimp.com/developer/marketing/api/e-commerce/products/list-store-products.md) - API Reference > E-commerce > Products [Add product](https://mailchimp.com/developer/marketing/api/e-commerce/products/create-store-product.md) - API Reference > E-commerce > Products [Get product info](https://mailchimp.com/developer/marketing/api/e-commerce/products/get-store-product.md) - API Reference > E-commerce > Products [Update product](https://mailchimp.com/developer/marketing/api/e-commerce/products/update-store-product.md) - API Reference > E-commerce > Products [Create or update product](https://mailchimp.com/developer/marketing/api/e-commerce/products/upsert-store-product.md) - API Reference > E-commerce > Products [Delete product](https://mailchimp.com/developer/marketing/api/e-commerce/products/delete-store-product.md) - API Reference > E-commerce > Products [List product images](https://mailchimp.com/developer/marketing/api/e-commerce/products/list-store-product-images.md) - API Reference > E-commerce > Products [Add product image](https://mailchimp.com/developer/marketing/api/e-commerce/products/create-store-product-image.md) - API Reference > E-commerce > Products [Get product image info](https://mailchimp.com/developer/marketing/api/e-commerce/products/get-store-product-image.md) - API Reference > E-commerce > Products [Update product image](https://mailchimp.com/developer/marketing/api/e-commerce/products/update-store-product-image.md) - API Reference > E-commerce > Products [Delete product image](https://mailchimp.com/developer/marketing/api/e-commerce/products/delete-store-product-image.md) - API Reference > E-commerce > Products [List product variants](https://mailchimp.com/developer/marketing/api/e-commerce/products/list-store-product-variants.md) - API Reference > E-commerce > Products [Add product variant](https://mailchimp.com/developer/marketing/api/e-commerce/products/create-store-product-variant.md) - API Reference > E-commerce > Products [Get product variant info](https://mailchimp.com/developer/marketing/api/e-commerce/products/get-store-product-variant.md) - API Reference > E-commerce > Products [Update product variant](https://mailchimp.com/developer/marketing/api/e-commerce/products/update-store-product-variant.md) - API Reference > E-commerce > Products [Add or update product variant](https://mailchimp.com/developer/marketing/api/e-commerce/products/upsert-store-product-variant.md) - API Reference > E-commerce > Products [Delete product variant](https://mailchimp.com/developer/marketing/api/e-commerce/products/delete-store-product-variant.md) - API Reference > E-commerce > Promo rules [List promo rules](https://mailchimp.com/developer/marketing/api/e-commerce/promo-rules/list-store-promo-rules.md) - API Reference > E-commerce > Promo rules [Add promo rule](https://mailchimp.com/developer/marketing/api/e-commerce/promo-rules/create-store-promo-rule.md) - API Reference > E-commerce > Promo rules [Get promo rule](https://mailchimp.com/developer/marketing/api/e-commerce/promo-rules/get-store-promo-rule.md) - API Reference > E-commerce > Promo rules [Update promo rule](https://mailchimp.com/developer/marketing/api/e-commerce/promo-rules/update-store-promo-rule.md) - API Reference > E-commerce > Promo rules [Delete promo rule](https://mailchimp.com/developer/marketing/api/e-commerce/promo-rules/delete-store-promo-rule.md) - API Reference > E-commerce > Promo rules [List promo codes](https://mailchimp.com/developer/marketing/api/e-commerce/promo-rules/list-store-promo-rule-promo-codes.md) - API Reference > E-commerce > Promo rules [Add promo code](https://mailchimp.com/developer/marketing/api/e-commerce/promo-rules/create-store-promo-rule-promo-code.md) - API Reference > E-commerce > Promo rules [Get promo code](https://mailchimp.com/developer/marketing/api/e-commerce/promo-rules/get-store-promo-rule-promo-code.md) - API Reference > E-commerce > Promo rules [Update promo code](https://mailchimp.com/developer/marketing/api/e-commerce/promo-rules/update-store-promo-rule-promo-code.md) - API Reference > E-commerce > Promo rules [Delete promo code](https://mailchimp.com/developer/marketing/api/e-commerce/promo-rules/delete-store-promo-rule-promo-code.md) - API Reference > Facebook Ads [List facebook ads](https://mailchimp.com/developer/marketing/api/facebook-ads/list.md) - API Reference > Facebook Ads [Get facebook ad info](https://mailchimp.com/developer/marketing/api/facebook-ads/get.md) - API Reference > File manager [List file manager resources](https://mailchimp.com/developer/marketing/api/file-manager/list.md) - API Reference > File manager > Files [List stored files](https://mailchimp.com/developer/marketing/api/file-manager/files/list-files.md) - API Reference > File manager > Files [Add file](https://mailchimp.com/developer/marketing/api/file-manager/files/create-file.md) - API Reference > File manager > Files [Get file](https://mailchimp.com/developer/marketing/api/file-manager/files/get-file.md) - API Reference > File manager > Files [Update file](https://mailchimp.com/developer/marketing/api/file-manager/files/update-file.md) - API Reference > File manager > Files [Delete file](https://mailchimp.com/developer/marketing/api/file-manager/files/delete-file.md) - API Reference > File manager > Folders [List folders](https://mailchimp.com/developer/marketing/api/file-manager/folders/list-folders.md) - API Reference > File manager > Folders [Add folder](https://mailchimp.com/developer/marketing/api/file-manager/folders/create-folder.md) - API Reference > File manager > Folders [Get folder](https://mailchimp.com/developer/marketing/api/file-manager/folders/get-folder.md) - API Reference > File manager > Folders [Update folder](https://mailchimp.com/developer/marketing/api/file-manager/folders/update-folder.md) - API Reference > File manager > Folders [Delete folder](https://mailchimp.com/developer/marketing/api/file-manager/folders/delete-folder.md) - API Reference > File manager > Folders [List stored files](https://mailchimp.com/developer/marketing/api/file-manager/folders/list-folder-files.md) - API Reference > Landing Pages [List landing pages](https://mailchimp.com/developer/marketing/api/landing-pages/list.md) - API Reference > Landing Pages [Add landing page](https://mailchimp.com/developer/marketing/api/landing-pages/create.md) - API Reference > Landing Pages [Get landing page info](https://mailchimp.com/developer/marketing/api/landing-pages/get.md) - API Reference > Landing Pages [Delete landing page](https://mailchimp.com/developer/marketing/api/landing-pages/delete.md) - API Reference > Landing Pages [Update landing page](https://mailchimp.com/developer/marketing/api/landing-pages/update.md) - API Reference > Landing Pages [Publish landing page](https://mailchimp.com/developer/marketing/api/landing-pages/create-action-publish.md) - API Reference > Landing Pages [Unpublish landing page](https://mailchimp.com/developer/marketing/api/landing-pages/create-action-unpublish.md) - API Reference > Landing Pages [Get landing page content](https://mailchimp.com/developer/marketing/api/landing-pages/list-content.md) - API Reference > Lists [Get lists info](https://mailchimp.com/developer/marketing/api/lists/list.md) - API Reference > Lists [Add list](https://mailchimp.com/developer/marketing/api/lists/create.md) - API Reference > Lists [Get list info](https://mailchimp.com/developer/marketing/api/lists/get.md) - API Reference > Lists [Update lists](https://mailchimp.com/developer/marketing/api/lists/update.md) - API Reference > Lists [Batch subscribe or unsubscribe](https://mailchimp.com/developer/marketing/api/lists/batch-subscribe-or-unsubscribe.md) - API Reference > Lists [Delete list](https://mailchimp.com/developer/marketing/api/lists/delete.md) - API Reference > Lists [List recent activity](https://mailchimp.com/developer/marketing/api/lists/list-activity.md) - API Reference > Lists [List top email clients](https://mailchimp.com/developer/marketing/api/lists/list-clients.md) - API Reference > Lists [List growth history data](https://mailchimp.com/developer/marketing/api/lists/list-growth-history.md) - API Reference > Lists [Get growth history by month](https://mailchimp.com/developer/marketing/api/lists/get-growth-history.md) - API Reference > Lists [List locations](https://mailchimp.com/developer/marketing/api/lists/list-locations.md) - API Reference > Lists [Search for tags on a list by name.](https://mailchimp.com/developer/marketing/api/lists/list-tag-search.md) - API Reference > Lists [List signup forms](https://mailchimp.com/developer/marketing/api/lists/list-signup-forms.md) - API Reference > Lists [Customize signup form](https://mailchimp.com/developer/marketing/api/lists/create-signup-form.md) - API Reference > Lists > Abuse reports [List abuse reports](https://mailchimp.com/developer/marketing/api/lists/abuse-reports/list-abuse-reports.md) - API Reference > Lists > Abuse reports [Get abuse report](https://mailchimp.com/developer/marketing/api/lists/abuse-reports/get-abuse-report.md) - API Reference > Lists > Interest categories [List interest categories](https://mailchimp.com/developer/marketing/api/lists/interest-categories/list-interest-categories.md) - API Reference > Lists > Interest categories [Add interest category](https://mailchimp.com/developer/marketing/api/lists/interest-categories/create-interest-category.md) - API Reference > Lists > Interest categories [Get interest category info](https://mailchimp.com/developer/marketing/api/lists/interest-categories/get-interest-category.md) - API Reference > Lists > Interest categories [Update interest category](https://mailchimp.com/developer/marketing/api/lists/interest-categories/update-interest-category.md) - API Reference > Lists > Interest categories [Delete interest category](https://mailchimp.com/developer/marketing/api/lists/interest-categories/delete-interest-category.md) - API Reference > Lists > Interest categories [List interests in category](https://mailchimp.com/developer/marketing/api/lists/interest-categories/list-interest-category-interests.md) - API Reference > Lists > Interest categories [Add interest in category](https://mailchimp.com/developer/marketing/api/lists/interest-categories/create-interest-category-interest.md) - API Reference > Lists > Interest categories [Get interest in category](https://mailchimp.com/developer/marketing/api/lists/interest-categories/get-interest-category-interest.md) - API Reference > Lists > Interest categories [Update interest in category](https://mailchimp.com/developer/marketing/api/lists/interest-categories/update-interest-category-interest.md) - API Reference > Lists > Interest categories [Delete interest in category](https://mailchimp.com/developer/marketing/api/lists/interest-categories/delete-interest-category-interest.md) - API Reference > Lists > Members [List members info](https://mailchimp.com/developer/marketing/api/lists/members/list-members.md) - API Reference > Lists > Members [Add member to list](https://mailchimp.com/developer/marketing/api/lists/members/create-member.md) - API Reference > Lists > Members [Get member info](https://mailchimp.com/developer/marketing/api/lists/members/get-member.md) - API Reference > Lists > Members [Update list member](https://mailchimp.com/developer/marketing/api/lists/members/update-member.md) - API Reference > Lists > Members [Add or update list member](https://mailchimp.com/developer/marketing/api/lists/members/upsert-member.md) - API Reference > Lists > Members [Archive list member](https://mailchimp.com/developer/marketing/api/lists/members/delete-member.md) - API Reference > Lists > Members [Delete list member](https://mailchimp.com/developer/marketing/api/lists/members/create-member-action-delete-permanent.md) - API Reference > Lists > Members [View recent activity 50](https://mailchimp.com/developer/marketing/api/lists/members/list-member-activity.md) - API Reference > Lists > Members [View recent activity](https://mailchimp.com/developer/marketing/api/lists/members/list-member-activity-feed.md) - API Reference > Lists > Members [List member events](https://mailchimp.com/developer/marketing/api/lists/members/list-member-events.md) - API Reference > Lists > Members [Add event](https://mailchimp.com/developer/marketing/api/lists/members/create-member-event.md) - API Reference > Lists > Members [List member goal events](https://mailchimp.com/developer/marketing/api/lists/members/list-member-goals.md) - API Reference > Lists > Members [List recent member notes](https://mailchimp.com/developer/marketing/api/lists/members/list-member-notes.md) - API Reference > Lists > Members [Add member note](https://mailchimp.com/developer/marketing/api/lists/members/create-member-note.md) - API Reference > Lists > Members [Get member note](https://mailchimp.com/developer/marketing/api/lists/members/get-member-note.md) - API Reference > Lists > Members [Update note](https://mailchimp.com/developer/marketing/api/lists/members/update-member-note.md) - API Reference > Lists > Members [Delete note](https://mailchimp.com/developer/marketing/api/lists/members/delete-member-note.md) - API Reference > Lists > Members [List member tags](https://mailchimp.com/developer/marketing/api/lists/members/list-member-tags.md) - API Reference > Lists > Members [Add or remove member tags](https://mailchimp.com/developer/marketing/api/lists/members/create-member-tag.md) - API Reference > Lists > Merge fields [List merge fields](https://mailchimp.com/developer/marketing/api/lists/merge-fields/list-merge-fields.md) - API Reference > Lists > Merge fields [Add merge field](https://mailchimp.com/developer/marketing/api/lists/merge-fields/create-merge-field.md) - API Reference > Lists > Merge fields [Get merge field](https://mailchimp.com/developer/marketing/api/lists/merge-fields/get-merge-field.md) - API Reference > Lists > Merge fields [Update merge field](https://mailchimp.com/developer/marketing/api/lists/merge-fields/update-merge-field.md) - API Reference > Lists > Merge fields [Delete merge field](https://mailchimp.com/developer/marketing/api/lists/merge-fields/delete-merge-field.md) - API Reference > Lists > Segments [List segments](https://mailchimp.com/developer/marketing/api/lists/segments/list-segments.md) - API Reference > Lists > Segments [Add segment](https://mailchimp.com/developer/marketing/api/lists/segments/create-segment.md) - API Reference > Lists > Segments [Get segment info](https://mailchimp.com/developer/marketing/api/lists/segments/get-segment.md) - API Reference > Lists > Segments [Update segment](https://mailchimp.com/developer/marketing/api/lists/segments/update-segment.md) - API Reference > Lists > Segments [Batch add or remove members](https://mailchimp.com/developer/marketing/api/lists/segments/batch-add-or-remove-members.md) - API Reference > Lists > Segments [Delete segment](https://mailchimp.com/developer/marketing/api/lists/segments/delete-segment.md) - API Reference > Lists > Segments [List members in segment](https://mailchimp.com/developer/marketing/api/lists/segments/list-segment-members.md) - API Reference > Lists > Segments [Add member to segment](https://mailchimp.com/developer/marketing/api/lists/segments/create-segment-member.md) - API Reference > Lists > Segments [Remove list member from segment](https://mailchimp.com/developer/marketing/api/lists/segments/delete-segment-member.md) - API Reference > Lists > Surveys [Get information about all surveys for a list](https://mailchimp.com/developer/marketing/api/lists/surveys/list-surveys.md) - API Reference > Lists > Surveys [Create survey](https://mailchimp.com/developer/marketing/api/lists/surveys/create-survey.md) - API Reference > Lists > Surveys [Get survey](https://mailchimp.com/developer/marketing/api/lists/surveys/get-survey.md) - API Reference > Lists > Surveys [Update survey](https://mailchimp.com/developer/marketing/api/lists/surveys/update-survey.md) - API Reference > Lists > Surveys [Delete survey](https://mailchimp.com/developer/marketing/api/lists/surveys/delete-survey.md) - API Reference > Lists > Surveys [Create a Survey Campaign](https://mailchimp.com/developer/marketing/api/lists/surveys/create-list-survey-action-create-email.md) - API Reference > Lists > Surveys [Publish a Survey](https://mailchimp.com/developer/marketing/api/lists/surveys/create-list-survey-action-publish.md) - API Reference > Lists > Surveys [Replicate survey](https://mailchimp.com/developer/marketing/api/lists/surveys/create-list-survey-action-replicate.md) - API Reference > Lists > Surveys [Unpublish a Survey](https://mailchimp.com/developer/marketing/api/lists/surveys/create-list-survey-action-unpublish.md) - API Reference > Lists > Webhooks [List webhooks](https://mailchimp.com/developer/marketing/api/lists/webhooks/list-webhooks.md) - API Reference > Lists > Webhooks [Add webhook](https://mailchimp.com/developer/marketing/api/lists/webhooks/create-webhook.md) - API Reference > Lists > Webhooks [Get webhook info](https://mailchimp.com/developer/marketing/api/lists/webhooks/get-webhook.md) - API Reference > Lists > Webhooks [Update webhook](https://mailchimp.com/developer/marketing/api/lists/webhooks/update-webhook.md) - API Reference > Lists > Webhooks [Delete webhook](https://mailchimp.com/developer/marketing/api/lists/webhooks/delete-webhook.md) - API Reference > Ping [Ping](https://mailchimp.com/developer/marketing/api/ping/list.md) - API Reference > Reporting [List reporting resources](https://mailchimp.com/developer/marketing/api/reporting/list.md) - API Reference > Reporting [List facebook ads reports](https://mailchimp.com/developer/marketing/api/reporting/list-facebook-ads.md) - API Reference > Reporting [Get facebook ad report](https://mailchimp.com/developer/marketing/api/reporting/get-facebook-ad.md) - API Reference > Reporting [List facebook ecommerce report](https://mailchimp.com/developer/marketing/api/reporting/list-facebook-ad-ecommerce-product-activity.md) - API Reference > Reporting [List landing pages reports](https://mailchimp.com/developer/marketing/api/reporting/list-landing-pages.md) - API Reference > Reporting [Get landing page report](https://mailchimp.com/developer/marketing/api/reporting/get-landing-page.md) - API Reference > Reporting [List survey reports](https://mailchimp.com/developer/marketing/api/reporting/list-surveys.md) - API Reference > Reporting [Get survey report](https://mailchimp.com/developer/marketing/api/reporting/get-survey.md) - API Reference > Reporting [List survey question reports](https://mailchimp.com/developer/marketing/api/reporting/list-survey-questions.md) - API Reference > Reporting [Get survey question report](https://mailchimp.com/developer/marketing/api/reporting/get-survey-question.md) - API Reference > Reporting [List answers for question](https://mailchimp.com/developer/marketing/api/reporting/list-survey-question-answers.md) - API Reference > Reporting [List survey responses](https://mailchimp.com/developer/marketing/api/reporting/list-survey-responses.md) - API Reference > Reporting [Get survey response](https://mailchimp.com/developer/marketing/api/reporting/get-survey-respons.md) - API Reference > Reports [List campaign reports](https://mailchimp.com/developer/marketing/api/reports/list.md) - API Reference > Reports [Get campaign report](https://mailchimp.com/developer/marketing/api/reports/get.md) - API Reference > Reports > Abuse reports [List abuse reports](https://mailchimp.com/developer/marketing/api/reports/abuse-reports/list-abuse-reports.md) - API Reference > Reports > Abuse reports [Get abuse report](https://mailchimp.com/developer/marketing/api/reports/abuse-reports/get-abuse-report.md) - API Reference > Reports > Advice [List campaign feedback](https://mailchimp.com/developer/marketing/api/reports/advice/list-advice.md) - API Reference > Reports > Click details [List campaign details](https://mailchimp.com/developer/marketing/api/reports/click-details/list-click-details.md) - API Reference > Reports > Click details [Get campaign link details](https://mailchimp.com/developer/marketing/api/reports/click-details/get-click-detail.md) - API Reference > Reports > Click details [List clicked link subscribers](https://mailchimp.com/developer/marketing/api/reports/click-details/list-click-detail-members.md) - API Reference > Reports > Click details [Get clicked link subscriber](https://mailchimp.com/developer/marketing/api/reports/click-details/get-click-detail-member.md) - API Reference > Reports > Domain performance [List domain performance stats](https://mailchimp.com/developer/marketing/api/reports/domain-performance/list-domain-performance.md) - API Reference > Reports > Ecommerce product activity [List campaign product activity](https://mailchimp.com/developer/marketing/api/reports/ecommerce-product-activity/list-ecommerce-product-activity.md) - API Reference > Reports > EepURL [List EepURL activity](https://mailchimp.com/developer/marketing/api/reports/eep-url/list-eepurl.md) - API Reference > Reports > Email activity [List email activity](https://mailchimp.com/developer/marketing/api/reports/email-activity/list-email-activity.md) - API Reference > Reports > Email activity [Get subscriber email activity](https://mailchimp.com/developer/marketing/api/reports/email-activity/get-email-activity.md) - API Reference > Reports > Locations [List top open activities](https://mailchimp.com/developer/marketing/api/reports/locations/list-locations.md) - API Reference > Reports > Open details [List campaign open details](https://mailchimp.com/developer/marketing/api/reports/open-details/list-open-details.md) - API Reference > Reports > Open details [Get opened campaign subscriber](https://mailchimp.com/developer/marketing/api/reports/open-details/get-open-detail.md) - API Reference > Reports > Sent to [List campaign recipients](https://mailchimp.com/developer/marketing/api/reports/sent-to/list-sent-to.md) - API Reference > Reports > Sent to [Get campaign recipient info](https://mailchimp.com/developer/marketing/api/reports/sent-to/get-sent-to.md) - API Reference > Reports > Sub reports [List child campaign reports](https://mailchimp.com/developer/marketing/api/reports/sub-reports/list-sub-reports.md) - API Reference > Reports > Unsubscribed [List unsubscribed members](https://mailchimp.com/developer/marketing/api/reports/unsubscribed/list-unsubscribed.md) - API Reference > Reports > Unsubscribed [Get unsubscribed member](https://mailchimp.com/developer/marketing/api/reports/unsubscribed/get-unsubscribed.md) - API Reference > Search Campaigns [Search campaigns](https://mailchimp.com/developer/marketing/api/search-campaigns/list.md) - API Reference > Sms Campaigns [List SMS campaigns](https://mailchimp.com/developer/marketing/api/sms-campaigns/list.md) - API Reference > Sms Campaigns [Add SMS campaign](https://mailchimp.com/developer/marketing/api/sms-campaigns/create.md) - API Reference > Sms Campaigns [Get SMS campaign info](https://mailchimp.com/developer/marketing/api/sms-campaigns/get.md) - API Reference > Sms Campaigns [Delete SMS campaign](https://mailchimp.com/developer/marketing/api/sms-campaigns/delete.md) - API Reference > Sms Campaigns [Update an SMS campaign](https://mailchimp.com/developer/marketing/api/sms-campaigns/update.md) - API Reference > Sms Campaigns [Cancel SMS campaign send](https://mailchimp.com/developer/marketing/api/sms-campaigns/create-action-cancel-send.md) - API Reference > Sms Campaigns [Schedule SMS campaign](https://mailchimp.com/developer/marketing/api/sms-campaigns/create-action-schedule.md) - API Reference > Sms Campaigns [Send SMS campaign](https://mailchimp.com/developer/marketing/api/sms-campaigns/create-action-send.md) - API Reference > Sms Campaigns [Get SMS campaign content](https://mailchimp.com/developer/marketing/api/sms-campaigns/get-content.md) - API Reference > Sms Campaigns [Set SMS campaign content](https://mailchimp.com/developer/marketing/api/sms-campaigns/upsert-content.md) - API Reference > Search Members [Search members](https://mailchimp.com/developer/marketing/api/search-members/list.md) - API Reference > Template Folders [List template folders](https://mailchimp.com/developer/marketing/api/template-folders/list.md) - API Reference > Template Folders [Add template folder](https://mailchimp.com/developer/marketing/api/template-folders/create.md) - API Reference > Template Folders [Get template folder](https://mailchimp.com/developer/marketing/api/template-folders/get.md) - API Reference > Template Folders [Delete template folder](https://mailchimp.com/developer/marketing/api/template-folders/delete.md) - API Reference > Template Folders [Update template folder](https://mailchimp.com/developer/marketing/api/template-folders/update.md) - API Reference > Templates [List templates](https://mailchimp.com/developer/marketing/api/templates/list.md) - API Reference > Templates [Add template](https://mailchimp.com/developer/marketing/api/templates/create.md) - API Reference > Templates [Get template info](https://mailchimp.com/developer/marketing/api/templates/get.md) - API Reference > Templates [Delete template](https://mailchimp.com/developer/marketing/api/templates/delete.md) - API Reference > Templates [Update template](https://mailchimp.com/developer/marketing/api/templates/update.md) - API Reference > Templates [View default content](https://mailchimp.com/developer/marketing/api/templates/list-default-content.md) - API Reference > Verified Domains [List sending domains](https://mailchimp.com/developer/marketing/api/verified-domains/list.md) - API Reference > Verified Domains [Add domain to account](https://mailchimp.com/developer/marketing/api/verified-domains/create.md) - API Reference > Verified Domains [Get domain info](https://mailchimp.com/developer/marketing/api/verified-domains/get.md) - API Reference > Verified Domains [Delete domain](https://mailchimp.com/developer/marketing/api/verified-domains/delete.md) - API Reference > Verified Domains [Verify domain](https://mailchimp.com/developer/marketing/api/verified-domains/create-action-verify.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://mailchimp.com/developer/marketing/openapi.json) - [OpenAPI YAML](https://mailchimp.com/developer/marketing/openapi.yaml) > **Note:** This page contains both a page directory (above) and the landing page content (below). The page directory is generated for agent use and does not appear on the landing page. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://mailchimp.com/developer/marketing/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://mailchimp.com/_mcp/server. # Power your campaigns with our marketing engine | Mailchimp Developer # Mailchimp Marketing API ## Power your campaigns with our marketing engine Manage audiences, integrate your data, and send timely, relevant email campaigns. [View quick start](/developer/marketing/build/start-developing/send-your-first-api-request)![Mailchimp Marketing API](/developer/_fern-img/dc7a0fbbf22cbf760fcb67c37b60d326725f2ba10e51d8bb65f6780c2d066093.webp) * ### Manage your audiences Leverage the Marketing API to integrate your users’ data with Mailchimp’s marketing scale. * [Import and export contacts](/developer/marketing/build/quickstarts/import-and-export-contacts) Move contacts between your application and an existing Mailchimp audience, in bulk or one at a time. * [Organize your contacts with tags](/developer/marketing/build/quickstarts/organize-contacts-with-tags) Use tags to bring your application’s email targeting and organization strategy into Mailchimp. * ### Automate marketing activities Sync events in your app with Mailchimp to create powerful email automations at scale. * [Track events that trigger automations](/developer/marketing/api/lists/create-member-event) Monitor and act on your users’ behavior outside emails with the Events endpoint. * [Run requests asynchronously with the batch endpoint](/developer/marketing/api-concepts/batch-operations) Scale large or long-running calls to the Marketing API with batch requests. * ### Integrate your data Use the Marketing API to keep your data in sync with Mailchimp. * [Synchronize audience data with webhooks](/developer/marketing/api-concepts/webhooks) Keep your data store in sync with your Mailchimp audience via webhooks. * [Access data on behalf of other users with OAuth 2](/developer/marketing/build/start-developing/set-up-an-oauth-app) Integrate your product with your users’ Mailchimp accounts by authenticating via OAuth. Join Mailchimp ## Helping you build your thing is our thing Creating a Mailchimp account is the first step to accessing our APIs and developer tools. [Create a Mailchimp account](https://login.mailchimp.com/signup/?entrypoint=mandrill) [See pricing](https://mailchimp.com/pricing/transactional-email/) ![](/developer/_fern-img/7694a4f1e5c0f6b8e958f7ab102facee530e39dbf42bbc0430883f36e2f47d9b.webp) 300+ app integrations Don’t reinvent the wheel. Connect all your tools to Mailchimp and unlock even more features. Data-backed guidance Mailchimp’s proprietary intelligence gives you smart recommendations to help boost your marketing and revenue. Award-winning support Get the help you need, whenever you need it with our 24/7 support.