Skip to main content
POST
Create an inbound SMS webhook

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

UUID — when present, deduplicates repeat submissions. See /api-reference/idempotency.

Body

application/json
url
string<uri>
required

HTTPS endpoint that receives a POST for every inbound text

Maximum string length: 2048
phone_number_id
integer

Only texts to this number (id from GET /v1/phone-numbers). Omit for all your numbers.

Required range: -9007199254740991 <= x <= 9007199254740991
description
string

A label for the webhook

Maximum string length: 100

Response

Success

data
object
required