Skip to main content
POST
/
notifications
/
api
/
v1
/
sms
/
webhooks
/
inbound
/
Carrier inbound-SMS callback
curl --request POST \
  --url https://www.closient.com/notifications/api/v1/sms/webhooks/inbound/ \
  --header 'Content-Type: application/json' \
  --data '
{
  "to": "<string>",
  "from": "<string>",
  "body": "<string>"
}
'
{
  "ok": true,
  "action": ""
}

Body

application/json

Inbound SMS payload from a carrier callback (Flowroute or voip.ms).

Carrier payloads differ; this schema captures the common fields. Flowroute posts JSON with to/from/body; voip.ms posts did/from/ message (mapped by the endpoint). Unknown extra keys are ignored.

​
to
string
required

Destination number that received the inbound SMS (our 844 or 833 DID), E.164.

​
from
string
required

The sender's phone number (the consumer), in E.164.

​
body
string
required

The raw inbound message text. Classified for STOP/HELP/START keywords.

Response

OK

Small acknowledgement returned to the carrier after processing.

​
ok
boolean
required

Whether the webhook was accepted and processed.

​
action
string
default:""

Action taken for an inbound message (stop/help/start/none), empty for status callbacks.