Install

composer require openemail/sdk

<?php use OpenEmail\OpenEmail; require __DIR__ . '/vendor/autoload.php'; $client = new OpenEmail(); $email = $client->emails->send([    'from' => 'Acme Billing <[email protected]>',    'to' => '[email protected]',    'subject' => 'Your September invoice',    'html' => '<p>Invoice attached.</p>',]); echo $email['id'], ' ', $email['status'], PHP_EOL;

new OpenEmail() reads the key from OPENEMAIL_API_KEY, so the code holds no credential. Pass apiKey: when your configuration lives somewhere else. To reach one client from anywhere, configure it once with OpenEmail::init() and fetch it with OpenEmail::getClient().

A response is the decoded JSON as an associative array, so $email['id'] reads the id. The keys keep the API’s names, and so do the methods and their named arguments, which is why scheduledAt and idempotencyKey: are written the same way here as in the API reference.

PHP 8.2 and up, with the curl and json extensions that almost every build ships with, and no other dependency. Requests go through one cURL handle per client, so a second request to the API reuses the connection the first one opened, and cURL decodes a compressed response for you.

It works under PHP-FPM, Apache, the command line and long-running workers such as a queue worker, RoadRunner or FrankenPHP. Under PHP-FPM every request starts fresh, so build the client once per request. In a long-running process, keep one for the life of the process. After pcntl_fork the child opens a connection of its own rather than reusing the parent’s.