Receive SMS

Our API will forward each incoming message to a server of your choosing by making an HTTP POST request. The POST will contain UTF-8 encoded XML. Your server needs to respond with a 200 OK status code to acknowledge receipt of the message, otherwise the API will retry at regular intervals.

Parameters

To

Your long number or shortcode

From

Phone number that sent the message, this will be in international format e.g. 441625588620

Content

Text of the message

Msg_ID

Unique ID mediaburst assigned to the message, use this if you want to raise a query and to make sure you don’t receive any duplicates.

Keyword

If you’re using a shared shortcode we’ll pass across the keyword that was matched. For dedicated numbers this isn’t used.

UDH

Any User Data Header received with the message. This is a binary header which will be passed across as a hex encoded string.

Network

Mobile network the message was recevied from (where available).

Example

Mobile number 441234567890 has sent the message “Hello World” to mediaburst shared shortcode 84433.

<?xml version="1.0" encoding="utf-8"?>
<MO>
    <To>84433</To>
    <From>441234567890</From>
    <Keyword>Hello</Keyword>
    <Content>Hello World</Content>
    <MsgId>AB_123456</MsgId>
    <Network>1</Network>
</MO>