Skip to main content
POST
/
curl --request POST \
  --url https://{callbackHost}/ \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data SMS-Type=Notification \
  --data SMS-NotifyId=321354 \
  --data SMS-Success=True \
  --data SMS-To=353861234567 \
  --data SMS-From=353871234568 \
  --data SMS-Verify=5fb4926bd7e461eddc6dc629f472bab4 \
  --data SMS-TotalToSend=1 \
  --data SMS-TotalSent=1 \
  --data SMS-TotalFailed=0 \
  --data 'SMS-TimeStamp=2026-04-09 16:03:16'
Delivery receipts confirm whether the mobile network delivered or failed a message.
Delivery receipts work across all send methods, including the OAuth API and legacy APIs.

​
Quick facts

ItemDetail
Formatapplication/x-www-form-urlencoded
TimingUsually seconds to minutes; can be delayed
VerificationSMS-Verify = MD5(SMS-NotifyId + SMS-Success + client secret)
Success response200 OK

Body

application/x-www-form-urlencoded
​
SMS-Type
string
required

Always Notification for delivery receipts.

Allowed value: "Notification"
​
SMS-NotifyId
string
default:321354
required

The recipient-level notifyId assigned when sending the message.

​
SMS-Success
enum<string>
default:True
required

Whether the message was delivered.

Available options:
True,
False
​
SMS-To
string
default:353861234567
required

Destination mobile number in Irish international format.

​
SMS-From
string
default:353871234568
required

Sender ID as it appeared on the recipient handset.

​
SMS-Verify
string
default:5fb4926bd7e461eddc6dc629f472bab4
required

MD5 verification hash built from SMS-NotifyId + SMS-Success + your Client Secret.

​
SMS-TotalToSend
integer
default:1
required

Total number of messages in the send.

​
SMS-TotalSent
integer
default:1
required

Number of messages successfully delivered.

​
SMS-TotalFailed
integer
default:0
required

Number of messages that failed.

​
SMS-TimeStamp
string
default:2026-04-09 16:03:16
required

Delivery time in UTC, formatted as yyyy-MM-dd HH:mm:ss.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}:[0-9]{2}:[0-9]{2}$

Response

200

Your webhook endpoint accepted the delivery receipt.

Last modified on June 11, 2026