Skip to main content

A python client for MailChimp Marketing API, with batch support

Project description

PyPI Package latest release License

A light wrapper around mailchimp-marketing that makes it easier to use batch operations.

Getting Started


pip install batch-mailchimp


This can be used as a drop-in replacement for mailchimp-marketing – just change the import at the top, and everything should work the same:

import batch_mailchimp as MailchimpMarketing

client = MailchimpMarketing.Client({
    "api_key": "YOUR_API_KEY",

The additional functionality comes when we initialise the client with batch=True:

import batch_mailchimp as MailchimpMarketing

client = MailchimpMarketing.Client({
    "api_key": "YOUR_API_KEY",
    "batch": True,

If we do this, operations are stored up in the client, to be run later. For example:

# Fetch all MailChimp lists

All new operations will be added to the batch. When we’re ready, we can run all the operations in the batch:

batch =

We can check the batch’s status using:


Once it has finished, we can get the response with:

response = batch.response()

API Structure and Endpoints

The API structure and endpoints match that of mailchimp-marketing. You should refer to their documentation for usage.


If you are having issues, please create an issue.


The project is licensed under the MIT License.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

batch-mailchimp-1.2.2.tar.gz (5.8 kB view hashes)

Uploaded source

Built Distribution

batch_mailchimp-1.2.2-py3-none-any.whl (6.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page