Skip to main content
A delivery report (DLR) is a confirmation message sent by a mobile carrier to the sender, indicating whether an SMS or MMS message was successfully delivered to the recipient. Wavix supports delivery report (DLR) webhooks and sends delivery status updates to your specified endpoint. Set a default webhook URL in the Wavix portal, or include a callback_url parameter in your Send SMS or MMS Message API request. If you provide a callback_url in the API request, Wavix sends the DLR to that URL. Otherwise, Wavix sends the DLR to the default webhook in your account settings.

​
Set up your DLR webhook URL

​
Using the app

To set a default DLR webhook:
  1. Sign in to your account.
  2. Go to Account & billing, then select My account.
  3. Select the Default destinations tab.
  4. Enter your callback URL in the DLR webhook field.
  5. Select Save changes.

​
In each API request

You can also include the callback_url parameter in your API request when sending a message. If you specify this parameter, Wavix uses it for the DLR instead of the account default. Request example: 
{
  "from": "SenderID",
  "to": "1686xxxxxxx",
  "message_body": {
    "text": "Your message text",
    "media": []
  },
  "callback_url": "https://service.com/callbacks/wavix/dlr"
}

​
Handling the callbacks

Wavix sends delivery reports as POST requests to your webhook URL. These updates are triggered when a message status changes:
  1. The first report is sent when the message is sent or fails to send.
  2. The second report is sent when the final delivery status is known (e.g. delivered, undelivered, rejected).
Sample payload: 
{
  "delivered": null,
  "error": null,
  "from": "SenderID",
  "message_id": "62845007-931a-4c3c-a581-6bdeffec75dc",
  "message_type": "sms",
  "segments_count": 1,
  "sent": "2025-03-21T08:09:02",
  "status": "sent",
  "to": "1686xxxxxxx",
  "tag": "Message tag"
}

​
Delivery report attributes

AttributeDescription
statusThe message’s interim or final status.
• sent - Submitted for delivery (interim)
• delivered - Successfully delivered (final)
• undelivered - Couldn’t be delivered (final)
• rejected - Rejected by a carrier, mobile device, or Wavix (final)
sentTimestamp when Wavix submitted the message for delivery
deliveredTimestamp when final status was received
fromSender ID
toRecipient’s phone number
message_idUnique identifier for the message
message_typesms or mms
segments_countNumber of SMS segments sent
tagCustom tag from the original request
errorError details, if any
⌘I