SMS messages

  • JSON
  • XML

SMS messages


# To send from a User-defined workspace

POST https://api.<region>

# To send from the default workspace

POST https://api.<region>


Authorization: Basic am9obi5zbWl0aDpteXBhc3N3b3Jk

x-api-key: your_api_key

Content-Type: application/vnd.whispir.message-v1+json

Accept: application/vnd.whispir.message-v1+json



"to" : "61400400400",

"subject" : "Test SMS Message",

"body" : "This is the body of my test SMS message"



Request Body Details




Ad-hoc recipients

  • Mobile phone: 61400400400
  • Landline phone: 61386000000

Defined Whispir recipients

  • Contact MRI:
  • User MRI:
  • Distribution List MRI:




A description of the SMS message to be sent




The content of the SMS message, up to 1600 characters*


  • SMS character counts are limited in some countries. Contact your local Whispir account manager for information about the supported number of characters in your region

  • MRI [Message Resource Identifier] is the unique Whispir address for the contact, user or distribution list

Sample Response

202 - Accepted

In this case the Location header in the Response Headers will show the direct link to the message. Depending on the endpoint of choice we will respectively have:



NOTE: if the Location Header containing the message_id wasn't collected at the time of sending please refer to Retrieve a previously sent message. This process is same for SMS, email, voice and push notifications