SMS API Documentation

Simple HTTP :: Receive SMS

Our API will forward each incoming message to a server of your choosing by making a simple HTTP GET or POST request.  All the parameters will be URL-Encoded UTF-8 text.  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.

Example

http://www.example.com/receive-sms?
to=84433&from=441234567890&content=Hello+World&keyword=hello&msg_id=AB_12345