Receive an outgoing message status

webhook

messageStatus

Outgoing delivery-status notification. Per-message statusCallback takes precedence and uses POST; number-level callbacks can use GET or POST. SmsStatusDetail is conditional.

Form Data

Receiver-side parsed fields, delivered as form values for POST or query values for GET. SmsStatusDetail is conditional. No JSON body is sent.

SmsSid

string

Outgoing SMS/MMS identifier.

SmsStatus

string

Delivery status supplied by the processing branch; a complete enum is not established here.

MessageStatus

string

Same value as SmsStatus.

string

Destination number, normalized by EnsurePlusOne.

MessageSid

string

Same outgoing message identifier.

AccountSid

string

TextGrid account identifier.

From

string

Sending TextGrid number, normalized by EnsurePlusOne.

Segments

integer

Message1Segments count. Form/query transport encodes this as text.

ApiVersion

string

enum

API version.

Allowed:

SmsStatusDetail

string

Mapped error detail; included only when ErrorReport is nonempty.

Headers

X-TextGrid-Signature

string

Base64 HMAC-SHA1 with the account WebhookSecret. GET signs the full requested URL including query parameters once; POST signs the original URL plus the raw body. Apply the documented non-ASCII escaping. See signature-verification.md.

Responses

200

Acknowledged by TextGrid.

201

Acknowledged by TextGrid.

202

Acknowledged by TextGrid.

204

Acknowledged by TextGrid.