texto / sdk

v1.0.0 2026-09-19 09:49 UTC

Requires

• php: >=8.0
• ext-curl: *
• ext-json: *

Requires (Dev)

• phpunit/phpunit: ^9.6 || ^10.5

MIT

• Texto (Floop Pty Ltd)

• sms
• messaging
• australia
• texto

Published on Packagist.org on 2026-09-19 10:41 UTC

README

Official PHP SDK for the Texto SMS API.

Requirements

• PHP 8.0 or newer
• ext-curl and ext-json

Install

composer require texto/sdk

Quick start

<?php
require 'vendor/autoload.php';

$texto = new Texto\Texto(getenv('TEXTO_API_KEY'));

$result = $texto->send('[phone]', 'Hello from Texto');
echo $result['message_id'];

echo $texto->balance(), " credits remaining\n";

Sending to many recipients

// Tip: include {{OptOutLink}} in the message to add a unique per-recipient
// opt-out link (texto.au/xxxxxx, 15 chars, always shortened) — recommended
// for Sender ID sends, where recipients can't reply STOP.
$texto->sendBatch(
    [
        ['to' => '[phone]', 'name' => 'Ada'],
        ['to' => '[phone]', 'name' => 'Grace'],
    ],
    'Hi {name}, your appointment is tomorrow.'
);

Plain strings work too when you are not using merge fields.

Errors

use Texto\Exception\InsufficientCreditsException;
use Texto\Exception\ApiException;

try {
    $texto->send('[phone]', 'Hello');
} catch (InsufficientCreditsException $e) {
    echo "Need {$e->creditsRequired()} credits, have {$e->creditsAvailable()}";
} catch (ApiException $e) {
    echo "{$e->status}: {$e->getMessage()}";
}

Sub-accounts

$account = $texto->createAccount('Acme Pty Ltd', ['email' => '[e-mail]']);
$texto->allocateCredits($account['account']['id'], 500);
$texto->listAccounts();

Webhooks

use Texto\Webhooks;

$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_TEXTO_SIGNATURE'] ?? null;

$event = Webhooks::parseEvent($payload, $signature, getenv('TEXTO_WEBHOOK_SECRET'));

if (Webhooks::isInboundEvent($event)) {
    // handle the reply
}

Configuration

$texto = new Texto\Texto(
    apiKey: getenv('TEXTO_API_KEY'),
    baseUrl: 'https://api.texto.com.au', // only change for a mock server or test proxy
    timeout: 30.0,
    maxRetries: 2
);

Idempotent requests are retried automatically with backoff.

Support

• Docs: https://texto.com.au/developers
• Email: [e-mail]

MIT licensed. Copyright (c) 2026 Floop Pty Ltd trading as Texto.