Webhook Payloads
Status Update Payload
Page Tools
WEBHOOKStatus V1 · Smobi → Your Server
Status events report message processing and delivery outcomes. Use smobiMessageId and clientRef to associate an update with the original request.
Smobi sends these payloads to your configured HTTPS receiver. These are outbound events, not callable endpoints on api.smobi.com. Configure Webhooks.
Payload Fields
application/jsonThe reference number of the message in the Smobi system
The reference number of the message in the client system
The phone number of the recipient
The phone number of the sender
The status of the message
Allowed values
"PROCESSING""SENT""FAILED""DELIVERED""READ"The timestamp of the status update
failureDetailsobject
Additional details about the status (for failed messages)
Show child fieldsHide child fields for payload.failureDetails
descriptionstring
The description of the status reason
Receiver Requirements
- Validate the authentication headers configured for your receiver.
- Persist or enqueue each accepted event before returning a successful
2xxresponse. - Handle repeated events and out-of-order status updates.