# Message Status Webhook

### Webhook Request Method
* **POST**
### Webhook Payload
|Parameter|type| Mandatory| Description|
|-|-|-|-|
|event|string|Yes|This is set to "message_status_update"
|business_phone|string|No|Business phone number
|message_id|string|Yes|Message ID
|message_status|string|Yes|Message status, one of "sent", "failed", "delivered", "read"
|error|object\|null|Yes| Error details，default is set to null.
|error.title|string|No| Service provider-defined error title.
|error.code|int|No| Service provider-defined error code.
|received_at|timestamp|Yes| Webhook received timestamp.
#### Webhook Sample
```json
{
  "event": "message_status_update",
  "business_phone": "6281519236680",
  "message_id": "wamid.HBgNNjI4OTY1MjQ1NjU0OBUCABEYEkYxNTY4NkNBRUY...",
  "message_status": "failed",
  "error": {
    "code": 131049,
    "title": "This message was not delivered to maintain healthy ecosystem engagement."
  },
  "received_at": 1754466101
},
```