All error codes
capability_not_supported
HTTP 400Not retryableThe phone number doesn't support what this request needs: a channel capability (SMS or MMS), calling through the API, or a call-instructions verb or option.
How to resolve
- Choose a sender whose capabilities include SMS (or MMS when sending media).
Example response
JSON
{
"object": "error",
"code": "capability_not_supported",
"message": "The phone number doesn't support what this request needs: a channel capability (SMS or MMS), calling through the API, or a call-instructions verb or option.",
"request_id": "req_example123",
"docs_url": "https://docs.statxt.com/api/errors/capability_not_supported",
"retryable": false,
"recommended_action": "Choose a number that supports it, or remove the unsupported verb or option."
}SDK handling
TypeScript
import { StatxtClient, StatxtApiError } from "@statxt/sdk"
const client = new StatxtClient({ apiKey: process.env.STATXT_API_KEY! })
try {
await client.messages.send({ ... })
} catch (err) {
if (err instanceof StatxtApiError && err.code === "capability_not_supported") {
// The phone number doesn't support what this request needs: a channel capability (SMS or MMS), calling through the API, or a call-instructions verb or option.
console.error(err.requestId) // include in support tickets
}
}Public reference: /docs/errors/capability_not_supported