MessagingMessagesWebhooks

Message status callback

View as MarkdownOpen in Claude

Payload sent by SignalWire to the status_callback URL each time a message transitions to a new state. The same payload shape is used for RELAY SDK message callbacks and SWML send_sms status callbacks.

Configure status_callback when sending a message.

Payload

The payload of this webhook request is an object.
idstringRequired
The unique ID of the message segment.
project_idstringRequired
The ID of the project the message belongs to.
statusenumRequired
The current delivery state of the message.
tostringRequired
The destination phone number.
fromstringRequired
The source phone number.
bodystringRequired
The message body text.
number_of_segmentsintegerRequired
Number of segments the message body was split into for delivery.
timestampdatetimeRequired
Timestamp of the status transition.
error_codestring or nullRequired

Provider-specific error code if delivery failed. Null when no error occurred.

error_messagestring or nullRequired

Human-readable error message if delivery failed. Null when no error occurred.

Response

200
Webhook received