PHP SDK

composer require veilmail/veilmail-php

<?php

require_once 'vendor/autoload.php';

$client = new VeilMail\VeilMail('veil_live_xxxxx');

$email = $client->emails->send([
    'from' => 'hello@yourdomain.com',
    'to' => 'user@example.com',
    'subject' => 'Hello from PHP!',
    'html' => '<h1>Welcome!</h1>',
]);

echo $email['id'];     // email_xxxxx
echo $email['status']; // queued

// Send with template
$email = $client->emails->send([
    'from' => 'hello@yourdomain.com',
    'to' => 'user@example.com',
    'templateId' => 'tmpl_xxx',
    'templateData' => ['name' => 'Alice'],
]);

// Send with attachments
$email = $client->emails->send([
    'from' => 'hello@yourdomain.com',
    'to' => 'user@example.com',
    'subject' => 'Invoice',
    'html' => '<p>Attached is your invoice.</p>',
    'attachments' => [
        [
            'filename' => 'invoice.pdf',
            'content' => $base64Content,
            'contentType' => 'application/pdf',
        ],
    ],
]);

// Batch send (up to 100)
$result = $client->emails->sendBatch([
    ['from' => 'hi@yourdomain.com', 'to' => ['u1@ex.com'], 'subject' => 'Hi', 'html' => '<p>Hi!</p>'],
    ['from' => 'hi@yourdomain.com', 'to' => ['u2@ex.com'], 'subject' => 'Hi', 'html' => '<p>Hi!</p>'],
]);

$subs = $client->audiences->subscribers('audience_xxxxx');

// Add a subscriber
$subscriber = $subs->add([
    'email' => 'user@example.com',
    'firstName' => 'Alice',
    'lastName' => 'Smith',
    'consentType' => 'express',
]);

// List subscribers
$result = $subs->list(['status' => 'active', 'limit' => 50]);
foreach ($result['data'] as $sub) {
    echo $sub['email'] . "\n";
}

// Import from CSV
$result = $subs->import(['csvData' => "email,firstName\nuser@example.com,Bob"]);
echo "Created: {$result['created']}, Skipped: {$result['skipped']}";

// Export as CSV
$csv = $subs->export(['status' => 'active']);

use VeilMail\Exceptions\RateLimitException;
use VeilMail\Exceptions\PiiDetectedException;
use VeilMail\Exceptions\ValidationException;
use VeilMail\Exceptions\AuthenticationException;
use VeilMail\Exceptions\VeilMailException;

try {
    $client->emails->send([
        'from' => 'hello@yourdomain.com',
        'to' => 'user@example.com',
        'subject' => 'Hello',
        'html' => '<p>Hi!</p>',
    ]);
} catch (RateLimitException $e) {
    echo "Rate limited. Retry after {$e->getRetryAfter()}s";
} catch (PiiDetectedException $e) {
    echo "PII detected: " . implode(', ', $e->getPiiTypes());
} catch (ValidationException $e) {
    echo "Validation error: {$e->getMessage()}";
} catch (AuthenticationException $e) {
    echo "Invalid API key";
} catch (VeilMailException $e) {
    echo "API error: {$e->getMessage()} (code: {$e->getErrorCode()})";
}

$body = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_SIGNATURE_HASH'] ?? '';

if (!VeilMail\Webhook::verifySignature($body, $signature, $webhookSecret)) {
    http_response_code(401);
    exit;
}

$event = json_decode($body, true);
switch ($event['type']) {
    case 'email.delivered':
        // Handle delivery
        break;
    case 'email.bounced':
        // Handle bounce
        break;
}

http_response_code(200);

use Illuminate\Http\Request;

class WebhookController extends Controller
{
    public function handle(Request $request)
    {
        $body = $request->getContent();
        $signature = $request->header('X-Signature-Hash', '');
        $secret = config('services.veilmail.webhook_secret');

        if (!\VeilMail\Webhook::verifySignature($body, $signature, $secret)) {
            return response('Unauthorized', 401);
        }

        $event = $request->json()->all();

        match ($event['type']) {
            'email.delivered' => $this->handleDelivered($event),
            'email.bounced' => $this->handleBounced($event),
            default => null,
        };

        return response('OK', 200);
    }
}