Message Status Event

Event name: message.status.update

Subscribe to this event to track message lifecycle in real time, from submission through to final delivery or failure.

When is this event triggered

The message.status.update event is dispatched each time a message transitions to a new status. Depending on the channel, a single message may generate multiple events as it progresses through the delivery pipeline (e.g., sent → delivered).

How to subscribe

1. Go to Applications > Manage > Webhooks.
2. Click Add Endpoint and enter your publicly accessible HTTPS URL.
3. Select message.status.update from the list of available events.
4. Save.

Payload structure

TextCall sends a POST request with a Content-Type: application/json header. Below is an annotated example of the payload:

{
  "event": "message.status.update",
  "data": {
    "message_id": "bbfe03d8-04be-4360-9092-b409873bd1f4",
    "channel": "SMS",
    "direction": "OUTBOUND",
    "sender": "SMSto",
    "recipient": "+35799849997",
    "parts": 1,
    "price": 0.5,
    "currency": "USD",
    "status": "DELIVERED",
    "error_code": null,
    "error_message": null
  }
}