SMS Delivery Receipts via HTTP

Delivery receipts let you know whether a message has been delivered. We forward them to you by making an HTTP request to a URL of your choice.

To enable delivery receipts on your account

  1. Login to Clockwork and choose “Delivery Receipts” under the “Sending” menu option
  2. Enter your server URL
  3. Set the Type to either HTTP Get or Form POST
  4. Save your settings

It takes around 30 minutes for delivery receipt changes to apply to your API account. We make HTTP calls on port 80 and HTTPS on port 443, so you shouldn’t need to open any more ports.

Parameters

Msg_ID

The Message ID returned when you sent the message.

To

Phone number the message was sent to

Status

Delivery status of the message.

Detail

The detail code provides more information on why a message has failed. Sometimes the mobile network doesn’t provide a reason, in these cases it will be set to unknown (1).

Example URL

http://www.example.com/sms-dlr? msg_id=AB_12345&status=DELIVRD&err_code=0&to=441234567890