Receive SMS via HTTP

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 Clockwork mobile number or shortcode

from

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

content

Text of the message

id

Unique ID Clockwork 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 URL

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