Skip to main content
POST
Send an SMS from an assigned number

Authorizations

Authorization
string
header
required

Workspace API key or delegated OAuth access token with /v1 resource audience. Administrative routes require the Better Auth browser session instead.

Headers

Idempotency-Key
string
required

Reuse for the same logical action and identical body; changed input returns 409.

Required string length: 1 - 200

Path Parameters

id
string
required

Body

application/json
to
string
required
Pattern: ^\+[1-9]\d{6,14}$
text
string
required
Required string length: 1 - 1600
attachments
object[]
Maximum array length: 10

Response

Successful JSON response

id
string
required
Minimum string length: 1
status
enum<string>
required

Operation state. Completed sends mean provider acceptance, not recipient delivery. Poll pending or unknown operations; do not resend with a new key.

Available options:
pending,
unknown,
completed,
failed
messageId
string | null
required
Minimum string length: 1
statusUrl
string
required
error
string | null
required
failure
object