Skip to main content
POST
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

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 July 14, 2026