All error codes

sender_not_assigned

HTTP 403Not retryable

Personal keys may only send from numbers assigned to the acting user (or shared sandbox numbers in test mode).

How to resolve

  • Personal keys may only send from numbers assigned to the acting user.
  • Use an organization-scoped key, or pick a sender assigned to you.

Example response

JSON

{
  "object": "error",
  "code": "sender_not_assigned",
  "message": "Personal keys may only send from numbers assigned to the acting user (or shared sandbox numbers in test mode).",
  "request_id": "req_example123",
  "docs_url": "https://docs.statxt.com/api/errors/sender_not_assigned",
  "retryable": false,
  "recommended_action": "Use a sender assigned to the acting user, or an organization-scoped key."
}

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 === "sender_not_assigned") {
    // Personal keys may only send from numbers assigned to the acting user (or shared sandbox numbers in test mode).
    console.error(err.requestId) // include in support tickets
  }
}

Public reference: /docs/errors/sender_not_assigned