HTTP API: How To Receive A Message

Using HTTP to Receive Texts and Delivery Receipts

Replies will be sent as an HTTP POST, unless the 'emailAddress' parameter was set when the message was submitted, in which case the reply will be sent by email. Please let us know the URL of the server that we should connect to for the POST.

Reply Parameters

The following parameters are required in all submissions to the API, and please note that they are all case-sensitive:

• mobileNumber: The phone number that the message was sent to.
• message: The message that was sent. Long replies are concatenated together and submitted in a single POST.
• dateAndTime: The timestamp of when the message was received.
• reference: The value of the reference parameter that was specified when the message was submitted, if applicable.
• senderLabel: The number of the mobile phone that sent the reply.

Delivery Receipt Parameters

• mobileNumber: The phone number that the message was sent to.
• status: The status of the message, for example delivered, expired, etc.
• dateAndTime: The timestamp of when the message was received.
• reference: The value of the reference parameter that was specified when the message was submitted, if applicable.

Having Problems?

We're very keen that your integration should be straightforward and easy, so if you're having any trouble at all, then please don't hesitate to get in touch.