Skip to navigation
API ReferenceMessages

Send using Mailchimp template

Send a new transactional message through Mandrill using a Mailchimp Transactional template.

Request

This endpoint expects an object.
keystringRequired
A valid Mandrill API key
mc_template_idintegerRequired
the Mailchimp Transactional template ID from the user's account
messageobjectRequired

the other information on the message to send - same as /messages/send

mc_template_versionenumOptional

which version of the template to use - "draft" for draft content or "published" for published content. Defaults to "published". Note: requesting "published" when the template has not been published will return a 404 error.

Allowed values:
asyncboolean or nullOptional

enable a background sending mode that is optimized for bulk sending. In async mode, messages/send will immediately return a status of "queued" for every recipient. To handle rejections when sending in async mode, set up a webhook for the 'reject' event. Defaults to false for messages with no more than 10 recipients; messages with more than 10 recipients are always sent asynchronously, regardless of the value of async.

ip_poolstringOptional
the name of the dedicated ip pool that should be used to send the message. If you do not have any dedicated IPs, this parameter has no effect. If you specify a pool that does not exist, your default pool will be used instead.
send_atstringOptionalformat: "^$|^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}(\.\d+)?$"

when this message should be sent as a UTC timestamp in YYYY-MM-DD HH:MM:SS format. If you specify a time in the past, the message will be sent immediately; for future dates, you're limited to one year from the date of scheduling.

Response

Success

Errors

401
Unauthorized Error
402
Payment Required Error
404
Not Found Error
500
Internal Server Error