Mailchimp Transactional — Python
The official Python client library for the Mailchimp Transactional API (v1)
Requirements.
Python 2.7 and 3.4+
Installation & Usage
pip install
If the python package is hosted on GitHub, you can install directly from GitHub
pip install git+https://github.com/mailchimp/mailchimp-transactional-python.git
(you may need to run pip
with root permission: sudo pip install git+https://github.com/mailchimp/mailchimp-transactional-python.git
)
Then import the package:
import mailchimp_transactional
Setuptools
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_transactional
Quick Start
Please follow the installation procedure and then run the following:
Quick Start
import mailchimp_transactional as MailchimpTransactional
from mailchimp_transactional.api_client import ApiClientError
try:
mailchimp = MailchimpTransactional.Client('YOUR_API_KEY')
response = mailchimp.users.ping()
print('API called successfully: {}'.format(response))
except ApiClientError as error:
print('An exception occurred: {}'.format(error.text))
Sending Requests
All requests are sent via POST and accept a single argument as the request body parameter.
mailchimp.templates.publish({ name: 'My Template' });
Output Formats
Optionally, you can set the default response format for all requests to one of the following:
json
(default)xml
php
yaml
mailchimp.set_default_output_format('xml');
You can also set the response format for a single request by passing in a special outputFormat
param to the request body.
mailchimp.senders.list({ outputFormat: 'php' });
PRs and Issues
This repo is autogenerated from https://github.com/mailchimp/mailchimp-client-lib-codegen -- please submit PRs or issues there!
API Endpoints
All URIs are relative to https://mandrillapp.com/api/1.0
Method | Endpoint |
---|---|
allowlists.add | /allowlists/add |
allowlists.delete | /allowlists/delete |
allowlists.list | /allowlists/list |
exports.activity | /exports/activity |
exports.allowlist | /exports/allowlist |
exports.info | /exports/info |
exports.list | /exports/list |
exports.rejects | /exports/rejects |
exports.whitelist | /exports/whitelist |
inbound.add_domain | /inbound/add-domain |
inbound.add_route | /inbound/add-route |
inbound.check_domain | /inbound/check-domain |
inbound.delete_domain | /inbound/delete-domain |
inbound.delete_route | /inbound/delete-route |
inbound.domains | /inbound/domains |
inbound.routes | /inbound/routes |
inbound.send_raw | /inbound/send-raw |
inbound.update_route | /inbound/update-route |
ips.cancel_warmup | /ips/cancel-warmup |
ips.check_custom_dns | /ips/check-custom-dns |
ips.create_pool | /ips/create-pool |
ips.delete | /ips/delete |
ips.delete_pool | /ips/delete-pool |
ips.info | /ips/info |
ips.list | /ips/list |
ips.list_pools | /ips/list-pools |
ips.pool_info | /ips/pool-info |
ips.provision | /ips/provision |
ips.set_custom_dns | /ips/set-custom-dns |
ips.set_pool | /ips/set-pool |
ips.start_warmup | /ips/start-warmup |
messages.cancel_scheduled | /messages/cancel-scheduled |
messages.content | /messages/content |
messages.info | /messages/info |
messages.list_scheduled | /messages/list-scheduled |
messages.parse | /messages/parse |
messages.reschedule | /messages/reschedule |
messages.search | /messages/search |
messages.search_time_series | /messages/search-time-series |
messages.send | /messages/send |
messages.send_raw | /messages/send-raw |
messages.send_template | /messages/send-template |
metadata.add | /metadata/add |
metadata.delete | /metadata/delete |
metadata.list | /metadata/list |
metadata.update | /metadata/update |
rejects.add | /rejects/add |
rejects.delete | /rejects/delete |
rejects.list | /rejects/list |
senders.add_domain | /senders/add-domain |
senders.check_domain | /senders/check-domain |
senders.domains | /senders/domains |
senders.info | /senders/info |
senders.list | /senders/list |
senders.time_series | /senders/time-series |
senders.verify_domain | /senders/verify-domain |
subaccounts.add | /subaccounts/add |
subaccounts.delete | /subaccounts/delete |
subaccounts.info | /subaccounts/info |
subaccounts.list | /subaccounts/list |
subaccounts.pause | /subaccounts/pause |
subaccounts.resume | /subaccounts/resume |
subaccounts.update | /subaccounts/update |
tags.all_time_series | /tags/all-time-series |
tags.delete | /tags/delete |
tags.info | /tags/info |
tags.list | /tags/list |
tags.time_series | /tags/time-series |
templates.add | /templates/add |
templates.delete | /templates/delete |
templates.info | /templates/info |
templates.list | /templates/list |
templates.publish | /templates/publish |
templates.render | /templates/render |
templates.time_series | /templates/time-series |
templates.update | /templates/update |
urls.add_tracking_domain | /urls/add-tracking-domain |
urls.check_tracking_domain | /urls/check-tracking-domain |
urls.list | /urls/list |
urls.search | /urls/search |
urls.time_series | /urls/time-series |
urls.tracking_domains | /urls/tracking-domains |
users.info | /users/info |
users.ping | /users/ping |
users.ping2 | /users/ping2 |
users.senders | /users/senders |
webhooks.add | /webhooks/add |
webhooks.delete | /webhooks/delete |
webhooks.info | /webhooks/info |
webhooks.list | /webhooks/list |
webhooks.update | /webhooks/update |
whitelists.add | /whitelists/add |
whitelists.delete | /whitelists/delete |
whitelists.list | /whitelists/list |
Additional Libraries
Mailchimp Transactional libraries are available in the following languages: