Messaging Webhooks

Messaging Webhooks allow you to receive HTTP callbacks at user-defined URIs when certain messaging events occur.

You can receive webhooks using GET or POST.

Events

The following events are supported.

Event Name Description
Message.Received Fired when an incoming message is received.
Message.DeliveryReceiptReceived Fired when a delivery receipt is received.

Parameters

Common Parameters

The following parameters are present in every request.

Parameter Type Description
Action string Value will be: Webhook
Event string The name of the event as per the event table.
Account.Sid string The secure identifier of the applicable account.
Property.Sid string The secure identifier of the applicable property.

Message Parameters

The following parameters are present in every incoming SMS or delivery receipt.

Parameter Type Description
Message.Sid string The secure identifier of the message.
Message.From string The sender ID of the sender of the message. This may be alphanumeric or in E164 international format with a + prefix.
Message.To string The recipient of the message. This will be in E164 international format with a + prefix.
Message.Text string The message body of the message that this request relates to. In the case of an incoming message, this is the incoming message text. In the case of a deliver receipt, this is the text of the original message that was sent.