# Webhook for message status updates

**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.



## Servers
- Webhook URL: https://example.com/webhook/message-status (Webhook URL)


## Authentication methods
- X api key


## Parameters



### Body: */* (object)
Payload for the message status update callback
- **event** (string)

- **module** (string)

- **dispatchId** (string)
  The Dispatch ID. For module DISPATCH_API is the id returned in the response of the message dispatch request, for BROADCAST the broadcast id
- **messageId** (string)
  The message ID.
- **messagePart** (integer(int32))
  Refers to the specific content of the translation sent in the request or the single content defined in the template used for sending.
- **messageTotalParts** (integer(int32))
  Total number of content parts, representing the actual number of messages sent to the recipient.
- **channel** (string)

- **channelIdentifier** (string)
  The user identifier for the current channel.
- **status** (string)

- **statusOrder** (integer(int32))
  The order number to be used for sorting statuses when notifications have the same timestamp. Notifications may arrive out of order due to provider behavior or webhook retries.
- **statusDate** (string(date-time))
  The date and time (UTC) of the status change.
- **dispatchMetadata** (object)
  General metadata sent in the message dispatch request (DISPATCH_API only).
- **recipientMetadata** (object)
  Metadata specific to the recipient associated with the channelIdentifier specified in the message dispatch request (DISPATCH_API only).


## Responses
### 200
Callback received successfully


[Powered by Bump.sh](https://bump.sh)