Error Codes

{
  "error": "Human-readable error message",
  "code": "machine_readable_code"
}

{
  "error": "Invalid credentials",
  "code": "invalid_credentials"
}

{
  "error": "Recipient phone number (to_msisdn) is required",
  "code": "missing_to"
}

{
  "error": "Invalid phone number format",
  "code": "invalid_phone"
}

{
  "error": "Sending number not found",
  "code": "list_not_found"
}

import requests

response = requests.post(
    "https://api.tracklysms.com/api/v1/messages",
    headers={"X-Api-Key": "your_key", "Content-Type": "application/json"},
    json={"to": "+14155551234", "body": "Hello", "from_phone_number_id": "pn_123"}
)

if response.status_code == 201:
    result = response.json()
    print(f"Message queued: {result['message_id']}")
elif response.status_code == 401:
    print("Authentication failed - check your API key")
elif response.status_code == 400:
    error = response.json()
    print(f"Validation error: {error['error']} (code: {error['code']})")
elif response.status_code == 404:
    print("Resource not found - check your from_phone_number_id")
else:
    print(f"Unexpected error: {response.status_code}")

try {
  const response = await axios.post(
    'https://api.tracklysms.com/api/v1/messages',
    { to: '+14155551234', body: 'Hello', from_phone_number_id: 'pn_123' },
    { headers: { 'X-Api-Key': 'your_key' } }
  );

  console.log('Message queued:', response.data.message_id);
} catch (error) {
  if (error.response) {
    const { status, data } = error.response;

    switch (status) {
      case 401:
        console.error('Authentication failed');
        break;
      case 400:
        console.error(`Validation error: ${data.error}`);
        break;
      case 404:
        console.error('Resource not found');
        break;
      default:
        console.error(`Error ${status}: ${data.error}`);
    }
  }
}

X-API-Deprecated: v1 is deprecated
Deprecation: true