invalid_sender

JSON

{
  "object": "error",
  "code": "invalid_sender",
  "message": "The requested sender phone number was not found, is not visible to this key, or cannot be used in this environment (for example a non-sandbox number on a test key).",
  "request_id": "req_example123",
  "docs_url": "https://docs.statxt.com/api/errors/invalid_sender",
  "retryable": false,
  "recommended_action": "Call list_phone_numbers or get_default_sender and use a visible sender."
}

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 === "invalid_sender") {
    // The requested sender phone number was not found, is not visible to this key, or cannot be used in this environment (for example a non-sandbox number on a test key).
    console.error(err.requestId) // include in support tickets
  }
}