sendbyte / sendbyte-php

v0.3.0 2026-10-12 00:11 UTC

Requires

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

MIT

• api
• email
• laravel
• transactional
• africa

Published on Packagist.org on 2026-10-12 16:49 UTC

README

The official PHP SDK for SendByte, the email API for Africa. Laravel friendly, requires only ext-curl and ext-json.

Install

composer require sendbyte/sendbyte-php

Requires PHP 8.1 or newer.

Quickstart

<?php

use SendByte\SendByte;

$sendbyte = new SendByte('sk_test_...');

$email = $sendbyte->sendEmail([
    'from' => 'PayLink <[e-mail]>',
    'to' => '[e-mail]',
    'subject' => 'Receipt for your payment',
    'html' => '<p>Thank you. Your payment was received.</p>',
]);

echo $email['id'];

Keys that start with sk_test_ run in the sandbox: every endpoint behaves the same, but nothing is actually delivered. Switch to an sk_live_ key to send for real.

Configuration

$sendbyte = new SendByte('sk_live_...', 'https://api.sendbyte.africa');

API

Emails

$sendbyte->sendEmail(['from' => ..., 'to' => ..., 'subject' => ..., 'html' => ...]);
$sendbyte->getEmail('em_123');
$sendbyte->listEmails(['limit' => 20, 'status' => 'delivered']);

to, cc, bcc, and reply_to accept a single address or an array. Pass idempotency_key to make retries safe, scheduled_at for future sends, and template_id with variables to render a server side template.

Domains

$domain = $sendbyte->createDomain('paylink.ng');
// $domain['dns_records'] lists the SPF, DKIM, and DMARC records to publish
$sendbyte->listDomains();
$sendbyte->getDomain($domain['id']);
$sendbyte->verifyDomain($domain['id']);

Webhooks

$endpoint = $sendbyte->createWebhook(
    'https://example.com/hooks/sendbyte',
    ['email.delivered', 'email.bounced']
);
// $endpoint['secret'] is shown once, store it now
$sendbyte->listWebhooks();
$sendbyte->disableWebhook($endpoint['id']);
$sendbyte->replayWebhookDelivery('evt_123');

Receiving email

Received emails count toward your sending quota (spam does not), so receiving stays off until you turn it on.

$sendbyte->enableReceiving();
$setup = $sendbyte->enableDomainReceiving('dom_123');
// publish $setup['mx_record'], then
$sendbyte->checkDomainReceiving('dom_123');

$page = $sendbyte->listReceivedEmails(['status' => 'received,held', 'limit' => 20]);
$email = $sendbyte->getReceivedEmail($page['data'][0]['id']);
echo $email['stripped_text'];

$sendbyte->replyToReceivedEmail($email['id'], ['text' => 'Thanks, we are on it.']);
$sendbyte->getEmailConversation('em_123');

$route = $sendbyte->createInboundRoute([
    'domain_id' => 'dom_123',
    'match_type' => 'exact',
    'match_value' => 'support',
    'action' => 'forward',
    'forward_to' => ['[e-mail]'],
]);
$sendbyte->listInboundRoutes('dom_123');
$sendbyte->updateInboundRoute($route['id'], ['enabled' => false]);
$sendbyte->deleteInboundRoute($route['id']);

Subscribe a webhook to email.received to get each email, with its body and 24-hour attachment links, as it arrives. Guide: https://docs.sendbyte.africa/guides/receiving

Verifying webhook signatures

Every webhook request carries a sendbyte-signature header. Verify it against the raw request body before trusting the payload.

$raw = file_get_contents('php://input');
$valid = SendByte::verifyWebhookSignature(
    $_ENV['SENDBYTE_WEBHOOK_SECRET'],
    $_SERVER['HTTP_SENDBYTE_SIGNATURE'] ?? null,
    $raw
);
if (!$valid) {
    http_response_code(401);
    exit;
}
// handle the event

The check rejects missing, malformed, tampered, and stale signatures (default tolerance is 300 seconds).

Errors

Failed requests throw a SendByteException carrying the API error shape.

use SendByte\SendByteException;

try {
    $sendbyte->sendEmail([...]);
} catch (SendByteException $e) {
    echo $e->errorCode . ' ' . $e->status . ' ' . $e->getMessage();
    echo $e->docsUrl;
}

Links

• Documentation: https://docs.sendbyte.africa

License

MIT