Documentation

Error handling

Interpret platform errors consistently and separate retryable from terminal failures.

Use response codes plus the machine-readable error payload to decide whether to retry or surface an action to an operator.

{
  "error": {
    "code": "invalid_recipient",
    "message": "The destination phone number is not valid for this channel."
  }
}

Retry only transient failures such as timeouts or temporary carrier issues.