sendmux / sdk

v3.0.0 2026-11-06 00:41 UTC

Requires

• php: ^8.2
• qubrics/core: ^3.0
• qubrics/mailbox: ^3.0
• qubrics/management: ^3.0
• qubrics/sending: ^3.0

MIT

Published on Packagist.org on 2026-11-06 23:48 UTC

README

Umbrella package for Qubrics PHP SDK clients.

Read the PHP SDK guide at qubrics.com/docs/sdks/php.

Requirements

• PHP 8.2 or newer.
• Composer.
• A Qubrics API key or REST OAuth grant for each API surface you call.

Installation

Run this command only after Packagist lists qubrics/sdk version 3.0.0. Until then, retain your existing Composer constraint.

composer require qubrics/sdk:^3.0

Before upgrading from 2.x, read the PHP 3.0 migration guide. SDK 3.0 requires all four Qubrics packages on 3.x. If you use 1.x, apply the PHP 2.0 migration guide first.

If your custom Guzzle client uses FileCookieJar or SessionCookieJar, back up its state and re-authenticate into a fresh jar when upgrading. Guzzle rejects old records without a boolean HostOnly; do not guess that value. Default Qubrics API clients do not enable cookies. See the upstream migration warning.

Usage

The umbrella package installs the core, sending, mailbox, and management packages together. Create clients through the surface package factories.

<?php

require __DIR__ . '/vendor/autoload.php';

use Qubrics\Mailbox\ClientFactory as MailboxFactory;
use Qubrics\Management\ClientFactory as ManagementFactory;
use Qubrics\Sending\ClientFactory as SendingFactory;

$sending = SendingFactory::createEmailsApi(
    getenv('QUBRICS_MAILBOX_API_KEY') ?: getenv('SENDMUX_MAILBOX_API_KEY') ?: null
);

$mailbox = MailboxFactory::createMailboxAPIApi(
    getenv('QUBRICS_MAILBOX_API_KEY') ?: getenv('SENDMUX_MAILBOX_API_KEY') ?: null
);

$management = ManagementFactory::createMailboxesApi(
    getenv('QUBRICS_ROOT_API_KEY') ?: getenv('SENDMUX_ROOT_API_KEY') ?: null
);

Note

qubrics/sdk installs all PHP SDK surfaces. It does not replace the surface factories.

For OAuth, use each factory's WithAccessToken variant, such as SendingFactory::createMetaApiWithAccessToken($accessToken). It accepts a bare token or a callable returning one. See OAuth setup and lifecycle.

Included packages

Package	Use it for	API key
qubrics/core	Shared helpers for auth, headers, retries, pagination, and errors.	Any Qubrics API key.
qubrics/sending	Sending API client.	smx_mbx_ or owner-approved smx_agent_
qubrics/mailbox	Mailbox API client.	smx_mbx_ or scoped smx_agent_
qubrics/management	Management API client.	smx_root_

The package also exposes Qubrics\Sdk\Sdk::VERSION for package-version checks.

Support

For help, include the package name, version, API surface, and sanitised request details. Do not include API keys, tokens, passwords, webhook secrets, customer data, or private account details.

• PHP SDK guide: qubrics.com/docs/sdks/php
• Sending API reference: qubrics.com/docs/sending-api/introduction
• Mailbox API reference: qubrics.com/docs/mailbox-api/introduction
• Management API reference: qubrics.com/docs/api/introduction
• API keys guide: qubrics.com/docs/guides/api-keys
• Source repository: github.com/qubrics/qubrics-sdk

License

MIT. See LICENSE.