Incoming MO Messages

In order to receive incoming SMS, it is necessary to acquire a number from the number inventory and assign it to one of your API Keys.

Upon a receipt of an incoming SMS that has been sent to one of the numbers assigned to your account, then an Incoming Message will be posted to a Webhook address. This Webhook address can be set up in the Customer Portal as part of the configuration of the Number that you have selected from the number pool and assigned to your account.

The incoming message Webhook should be acknowledged with an HTTP 200 OK response. If the incoming message is unable to connect to the Webhook address or if a non HTTP 200 Ok response is received, it will be queued and re-tried for up to 24 hours before being discarded.

The Webhook call will be sent as a POST with a JSON document in the request body. It will be of the following format:

{
  "message_id": "...the message id returned in the submit sms API request...",
  "sender_address": "...sender address...",
  "destination_address": "...destination phone number...",
  "content_type": "text, unicode or binary",
  "udh": "...hex representation of the udh field if present in the message...",
  "message_body": "The contents of the message being delivered"
}