Webhook for message status updates

Webhook

POST

Message Status Update

This webhook is triggered when the status of a sent message changes.
A separate notification is sent for each actual message sent.
"The possible status updates are: DELIVERED, READ, FAILED (only for the last channel of the fallback chain), and NOSENT.
"Notifications are only sent for the final delivery channel. If a webhook call fails, retries will be performed at increasing intervals for up to 48 hours.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params */*Required

Examples

Responses

🟢200

Callback received successfully

This response does not have a body.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://your-api-server.com' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: */*' \
--data-raw '{
    "event": "DISPATCH_STATUS",
    "module": "BROADCAST",
    "dispatchId": "0FCB1XXXVEABC",
    "messageId": "0FCB1ABCVEXYZ",
    "messagePart": 1,
    "messageTotalParts": 3,
    "channel": "RCS",
    "channelIdentifier": "+390000000",
    "status": "DISPATCHED",
    "statusOrder": 10,
    "statusDate": "2024-01-01T14:30:00Z",
    "dispatchMetadata": {
        "property1": "string",
        "property2": "string"
    },
    "recipientMetadata": {
        "property1": "string",
        "property2": "string"
    }
}'

Modified at 2026-01-24 07:01:45

User Information

Webhook for incoming message notification