The official Python client library for the Mailchimp Marketing API

Python 2.7 and 3.4+

If the python package is hosted on GitHub, you can install directly from GitHub

pip install git+https://github.com/mailchimp/mailchimp-marketing-python.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/mailchimp/mailchimp-marketing-python.git)

Then import the package:

import mailchimp_marketing

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import mailchimp_marketing

Please follow the installation procedure and then run the following:

import mailchimp_marketing as MailchimpMarketing
from mailchimp_marketing.api_client import ApiClientError

try:
  client = MailchimpMarketing.Client()
  client.set_config({
    "api_key": "YOUR_API_KEY",
    "server": "YOUR_SERVER_PREFIX"
  })
  response = client.ping.get()
  print(response)
except ApiClientError as error:
  print(error)

The client library can be configured to use either Basic Auth or OAuth2.

For either method, a server prefix should be passed in i.e. us19, in order for the client to determine to appropriate host url.

client.set_config({
  "api_key": "YOUR_API_KEY",
  "server": "YOUR_SERVER_PREFIX"
})

client.set_config({
  "access_token": "YOUR_ACCESS_TOKEN",
  "server": "YOUR_SERVER_PREFIX"
})

This repo is autogenerated from https://github.com/mailchimp/mailchimp-client-lib-codegen -- please submit PRs or issues there!

All URIs are relative to https://server.api.mailchimp.com/3.0

Mailchimp Marketing libraries are available in the following languages: