Skip to navigation
API ReferenceMessages

Send a message

Send a new transactional message through Mandrill

Note

If you signed up for a Mandrill account on or after December 1st, 2015, you must add SPF and DKIM records and verify ownership of your sending domains before you can send email through your account. Mandrill will not send any email from unverified domains or domains without valid SPF and DKIM records, including public domains like gmail.com, yahoo.com, and more.

Custom signing domains are only available to Mandrill accounts created before December 1st, 2015. If you signed up for a new Mandrill account on or after December 1st, 2015, the signing_domain parameter will be ignored.

Mail sent from unverified domains or domains without valid SPF and DKIM records will be rejected with the reject_reason, unsigned.

Learn more about SPF and DKIM, and domain verification

Request

This endpoint expects an object.
keystringRequired
A valid Mandrill API key
messageobjectRequired
the information on the message to send
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
emailstringformat: "email"
The email address of the recipient
statusenum
The sending status of the recipient
Allowed values:
_idstring
The message's unique id
reject_reasonenumOptional
The reason for the rejection if the recipient status is rejected
queued_reasonenumOptional
The reason for the queuing if the recipient status is queued

Errors

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