Skip to main content
POST
/
api
/
webhook
/
twilio
/
sms-status
Handle Twilio SMS status callback
curl --request POST \
  --url https://your-instance.example.com/api/webhook/twilio/sms-status \
  --header 'Content-Type: application/json' \
  --data '
{
  "MessageSid": "SM5f7b1c2e8a1d4e0012c3b4a5",
  "MessageStatus": "delivered",
  "To": "+14165550100",
  "From": "+12362320246"
}
'
"OK"

Body

application/json
​
MessageSid
string

Twilio-assigned message identifier whose status is being reported.

​
MessageStatus
string

Delivery state: queued, sent, delivered, failed, undelivered.

​
To
string

Recipient phone number for the outbound message.

​
From
string

Tether-provisioned Twilio number the message was sent from.

​
ErrorCode
string

Twilio error code when delivery failed (e.g. 30003).

​
ErrorMessage
string

Human-readable error description paired with ErrorCode.

Response

Plain-text acknowledgement (Twilio only checks the 2xx status).

The response is of type string.

Example:

"OK"