Texto for Developers

composer require guzzlehttp/guzzle

<?php
use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;

$client = new Client(['base_uri' => 'https://api.texto.com.au/']);

function sendSms(Client $client, string $to, string $message, ?string $campaign = null): array
{
    $response = $client->post('send', [
        'headers' => [
            'Authorization' => 'Bearer ' . getenv('TEXTO_API_KEY'),
            'Content-Type'  => 'application/json',
        ],
        'json' => array_filter([
            'to'       => $to,
            'message'  => $message,
            'campaign' => $campaign,
        ]),
    ]);

    return json_decode((string) $response->getBody(), true);
}

$result = sendSms($client, '+61412345678', 'Your order has shipped.', 'order-updates');
echo $result['message_id'], ' ', $result['credits_remaining'];

try {
    $result = sendSms($client, '+61412345678', 'Hello');
} catch (RequestException $e) {
    // 401 invalid key · 402 out of credits · 422 invalid number · 429 rate limited
    $status = $e->getResponse()?->getStatusCode();
    $body   = (string) $e->getResponse()?->getBody();
    error_log("Texto {$status}: {$body}");
}

pip install requests

# texto.py
import os
import requests

BASE_URL = "https://api.texto.com.au"
API_KEY = os.environ["TEXTO_API_KEY"]


def send_sms(to: str, message: str, campaign: str | None = None) -> dict:
    response = requests.post(
        f"{BASE_URL}/send",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json",
        },
        json={k: v for k, v in {
            "to": to,
            "message": message,
            "campaign": campaign,
        }.items() if v is not None},
        timeout=15,
    )
    response.raise_for_status()
    return response.json()


result = send_sms("+61412345678", "Your order has shipped.", "order-updates")
print(result["message_id"], result["credits_remaining"])

from requests import HTTPError

try:
    send_sms("+61412345678", "Hello")
except HTTPError as err:
    # 401 invalid key · 402 out of credits · 422 invalid number · 429 rate limited
    print(err.response.status_code, err.response.text)

# System.Net.Http and System.Text.Json ship with .NET.
# Register a typed client in Program.cs:
builder.Services.AddHttpClient("texto", c =>
    c.BaseAddress = new Uri("https://api.texto.com.au/"));

using System.Net.Http.Json;
using System.Net.Http.Headers;

public record SendSmsRequest(string To, string Message, string? Campaign = null);
public record SendSmsResponse(string message_id, int credits_used, int credits_remaining);

public class TextoClient(HttpClient http, string apiKey)
{
    public async Task<SendSmsResponse> SendSmsAsync(SendSmsRequest request)
    {
        http.DefaultRequestHeaders.Authorization =
            new AuthenticationHeaderValue("Bearer", apiKey);

        var response = await http.PostAsJsonAsync("send", new
        {
            to = request.To,
            message = request.Message,
            campaign = request.Campaign,
        });

        response.EnsureSuccessStatusCode();
        return (await response.Content.ReadFromJsonAsync<SendSmsResponse>())!;
    }
}

var result = await client.SendSmsAsync(
    new SendSmsRequest("+61412345678", "Your order has shipped.", "order-updates"));
Console.WriteLine($"{result.message_id} {result.credits_remaining}");

try
{
    await client.SendSmsAsync(new SendSmsRequest("+61412345678", "Hello"));
}
catch (HttpRequestException ex)
{
    // 401 invalid key · 402 out of credits · 422 invalid number · 429 rate limited
    Console.Error.WriteLine($"Texto {(int?)ex.StatusCode}: {ex.Message}");
}