PHP SDK

<?php
use Usgm\UsglobalmailClient;
$usgm = new UsglobalmailClient(getenv('USGM_API_KEY')); // never hard-code the key

<?php
use Usgm\Mails\Requests\MailsListRequest;
use Usgm\Folders\Requests\CreateFolderDto;
// Your account profile
$account = $usgm->account->get();
echo $account->email . PHP_EOL;
// List mail, one page at a time (cursor pagination)
$cursor = null;
do {
    $page = $usgm->mails->list(new MailsListRequest(cursor: $cursor));
    foreach ($page->data as $mail) {
        echo $mail->id . ' ' . $mail->senderName . PHP_EOL;
    }
    $cursor = $page->nextCursor;
} while ($cursor !== null);
// Fetch one item
$mail = $usgm->mails->get('80421');
// Create a folder
$folder = $usgm->folders->create(new CreateFolderDto(name: 'Taxes'));

<?php
use Usgm\Exceptions\UsglobalmailApiException;
try {
    $usgm->mails->get('does-not-exist');
} catch (UsglobalmailApiException $err) {
    // getBody() is the RFC 9457 problem+json payload (code, request_id, detail, …)
    error_log($err->getCode() . ' ' . json_encode($err->getBody()));
    throw $err;
}