---
title: "Handle Twilio Inbound Sms"
method: POST
path: "/webhooks/twilio/sms"
tags: ["webhooks", "twilio"]
---

# Handle Twilio Inbound Sms

`POST /webhooks/twilio/sms`

## Request

- Base URL: `https://api.trytrata.com`
- URL: `https://api.trytrata.com/webhooks/twilio/sms`
- Auth: none declared

Sync sms_opted_in when a user replies STOP/START to our number.

Prefer Twilio's normalized OptOutType (handles punctuation, multi-word, and
carrier variants); fall back to matching the raw Body against known keywords.

## Query parameters

- `token` string, required

## Request body `application/x-www-form-urlencoded`

- BodyWebhooksHandleTwilioInboundSms
  - `From` string, required
  - `Body` string
  - `OptOutType` string

## Response `200`

Successful Response

- unknown

## Other responses

- `404`: Not found
- `422`: Validation Error

## Changes

- **2026-09-22** `b680cbbd8073`: 1 info
  - api tag `twilio` added

[Operation history](https://skmtc.dev/trytrata/apis/trytrata-api/changes/webhooks/twilio/sms/post.md)

---

[API](https://skmtc.dev/trytrata/apis/trytrata-api.md) - [All operations](https://skmtc.dev/trytrata/apis/trytrata-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytrata/apis/trytrata-api/revisions/a6a3d5ff6ed0?raw)