MessageStatusWebhookPayload

Normalized delivery status emitted by messaging providers and by the Hub. providerMessageId may be absent for Hub-generated events.

eventTypestringrequired

Possible values: [message_status]

is_sandboxboolean

Present when the status belongs to a Sandbox message.

Possible values: [true]

messageIdstring<uuid>

Internal Hub message identifier when the provider event can be correlated, including WhatsApp deleted statuses.

providerMessageIdstring

timestampstring<date-time>required

statusstringrequired

Possible values: [queued, sent, delivered, read, played, error, audio_transcription, deleted]

errorCodestring

Provider error identifier. For Brazilian SMS, this contains the original terminal provider status, such as InvalidNumber or Blocked.

errorMessagestring

errorDetailsstring

transcriptionstring

expiresAtstring<date-time>

Session expiry, if available; replay preserves the original value.

MessageStatusWebhookPayload

{
  "eventType": "message_status",
  "messageId": "2d07a67f-d410-46a4-95b0-7b1952a1fcfa",
  "providerMessageId": "wamid.example",
  "timestamp": "2026-10-06T15:00:00.000Z",
  "status": "delivered"
}