Skip to navigation
API ReferenceMessages

Send SMS message

Send a new SMS message through Mandrill

Request

This endpoint expects an object.
keystringRequired
A valid Mandrill API key
messageobjectRequired
asyncboolean or nullOptional

enable a background sending mode that is optimized for bulk sending. In async mode, messages/send-sms 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.

Response

Success
tostringformat: "^\+[1-9]\d{1,14}$"
The phone number of the recipient
fromstring
The phone number of the sender
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
queue_reasonenumOptional
The reason for the queuing if the recipient status is queued
Allowed values:

Errors

401
Unauthorized Error
404
Not Found Error
500
Internal Server Error