Log inTry for free
Back to all APIs
This endpoint is deprecated.

Receive outbound SMS message report Webhook

For every message you send, we offer the option to receive a delivery report. To use this feature, you should set up an endpoint to receive these reports. You can specify the endpoint when sending SMS. Alternatively, you can set the endpoint URL through the Subscriptions management. If you need assistance with this process, please contact support@infobip.com. Please note that the default number of delivery reports in a single request is 100. You can customize this value by defining "maxBucketSize" using the Subscription Management API.
You'll receive this type of payload for messages sent using Send SMS message and Send binary SMS message.

Learn more about the SMS channel and its use cases
post
https://{yourDomain}/your/webhook/path
Request Body schema:
application/json
collapse all -
results
Array of objects
Array
bulkId
string

Unique ID assigned to the request if messaging multiple recipients or sending multiple messages via a single API request.

messageId
string

Unique message ID.

to
string

Message destination address.

from
string

The sender ID which can be alphanumeric or numeric (e.g., CompanyName).

sentAt
string <date-time>

Date and time when the message was scheduled to be sent. Has the following format: yyyy-MM-dd'T'HH:mm:ss.SSSZ.

doneAt
string <date-time>

Date and time when the Infobip services finished processing the message (i.e., delivered to the destination, delivered to the destination network, etc.). Has the following format: yyyy-MM-dd'T'HH:mm:ss.SSSZ.

smsCount
integer <int32>

The number of parts the message content was split into.

mccMnc
string

Mobile country and network codes.

callbackData
string

Callback data sent through ‛callbackData‛ field when sending message.

price
object

Sent SMS price.

pricePerMessage
number <double>

Price per one SMS.

currency
string

The currency in which the price is expressed.

status
object

Indicates the status of the message and how to recover from an error should there be any.

groupId
integer <int32>

Status group ID.

groupName
string

Status group name that describes which category the status code belongs to, e.g. PENDING, UNDELIVERABLE, DELIVERED, EXPIRED, REJECTED.

id
integer <int32>

Status ID.

name
string

Status name.

description
string

Human-readable description of the status.

action
string

Action that should be taken to recover from the error.

error
object

Indicates whether an error occurred during the query execution.

groupId
integer <int32>

Error group ID.

groupName
string

Error group name.

id
integer <int32>

Error ID.

name
string

Error name.

description
string

Human-readable description of the error..

permanent
boolean

Tells if the error is permanent.

entityId
string

The entity used when sending the message. For more details, see our documentation.

applicationId
string

The application used when sending the message. For more details, see our documentation.

campaignReferenceId
string

ID that allows you to track, analyze, and show an aggregated overview and the performance of individual campaigns per sending channel.

Responses

200

Your server returns this code if it accepts the callback.

Request samples

Content type
application/json
Copy
 Collapse all
{
  • "results":
    [
    • {
      • "bulkId": "BULK-ID-123-xyz",
      • "messageId": "MESSAGE-ID-123-xyz",
      • "to": "41793026727",
      • "sentAt": "2019-11-09T16:00:00.000+0000",
      • "doneAt": "2019-11-09T16:00:00.000+0000",
      • "smsCount": 1,
      • "callbackData": "callbackData",
      • "price":
        {
        • "pricePerMessage": 0.01,
        • "currency": "EUR"
        },
      • "status":
        {
        • "groupId": 3,
        • "groupName": "DELIVERED",
        • "id": 5,
        • "name": "DELIVERED_TO_HANDSET",
        • "description": "Message delivered to handset"
        },
      • "error":
        {
        • "groupId": 0,
        • "groupName": "Ok",
        • "id": 0,
        • "name": "NO_ERROR",
        • "description": "No Error",
        • "permanent": false
        },
      • "entityId": "promotional-traffic-entity",
      • "applicationId": "marketing-automation-application"
      },
    • {
      • "bulkId": "BULK-ID-123-xyz",
      • "messageId": "12db39c3-7822-4e72-a3ec-c87442c0ffc5",
      • "to": "41793026834",
      • "sentAt": "2019-11-09T17:00:00.000+0000",
      • "doneAt": "2019-11-09T17:00:00.000+0000",
      • "smsCount": 1,
      • "price":
        {
        • "pricePerMessage": 0.01,
        • "currency": "EUR"
        },
      • "status":
        {
        • "groupId": 3,
        • "groupName": "DELIVERED",
        • "id": 5,
        • "name": "DELIVERED_TO_HANDSET",
        • "description": "Message delivered to handset"
        },
      • "error":
        {
        • "groupId": 0,
        • "groupName": "Ok",
        • "id": 0,
        • "name": "NO_ERROR",
        • "description": "No Error",
        • "permanent": false
        },
      • "applicationId": "default"
      }
    ]
}

Need assistance

Explore Infobip Tutorials

Encountering issues

Contact our support

What's new? Check out

Release Notes

Unsure about a term? See

Glossary

Research panel

Help shape the future of our products
Learn more
Service status

Copyright @ 2006-2025 Infobip ltd.

Privacy documentsTerms of use