Receive an incoming SMS/MMS

webhook

incomingMessage

Incoming SMS/MMS notification to the number SmsUrl. GET uses query values; POST uses form fields. Indexed media fields start at zero. Return an acknowledgment or supported messaging TwiML.

Form Data

Receiver-side parsed fields, delivered as form values for POST or query values for GET. MediaContentType0/MediaUrl0 pairs are emitted for each media item. No JSON body is sent.

SmsMessageSid

string

Incoming message identifier.

NumMedia

integer

Media item count. Form/query transport encodes this as text.

SmsSid

string

Same incoming message identifier.

SmsStatus

string

enum

Incoming message status.

Allowed:

Body

string

Incoming message text; may be omitted if the value is null.

string

Receiving TextGrid number, normalized by EnsurePlusOne.

NumSegments

integer

Incoming segment count. Form/query transport encodes this as text.

MessageSid

string

Same incoming message identifier.

AccountSid

string

TextGrid account identifier.

From

string

Sender number, normalized by EnsurePlusOne.

ApiVersion

string

enum

API version.

Allowed:

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.