README

Sendmux Sending API client for PHP.

Read the PHP SDK guide at sendmux.ai/docs/sdks/php.

Requirements

PHP 8.2 or newer.
Composer.
A mailbox-scoped API key with the smx_mbx_ prefix.

Installation

composer require sendmux/sending:^1.0

Usage

Create the API group client with a mailbox-scoped key.

<?php

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

use Sendmux\Sending\ClientFactory;

$emails = ClientFactory::createEmailsApi(
    getenv('SENDMUX_MAILBOX_API_KEY') ?: ''
);

$meta = ClientFactory::createMetaApi(
    getenv('SENDMUX_MAILBOX_API_KEY') ?: ''
);

The generated EmailsApi exposes sendingSendEmail() and sendingSendEmailBatch(). The generated MetaApi exposes sendingGetOpenApiSpec().

Features

Validates smx_mbx_ API keys before configuring the client.
Uses https://smtp.sendmux.ai/api/v1 by default.
Adds retry and rate-limit backoff behaviour through sendmux/core.
Maps generated API responses into the shared Sendmux envelope and error model.
Includes generated models for single-send and batch-send requests and responses.

Related packages

Package	Use it for
`sendmux/core`	Shared helpers for auth, headers, retries, pagination, and errors.
`sendmux/mailbox`	Mailbox API client.
`sendmux/management`	Management API client.
`sendmux/sdk`	Umbrella package that installs all PHP SDK surfaces.

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: sendmux.ai/docs/sdks/php
Sending API reference: sendmux.ai/docs/sending-api/introduction
API keys guide: sendmux.ai/docs/guides/api-keys
Source repository: github.com/Sendmux/sendmux-sdk

License

MIT. See LICENSE.

sendmux / sending

Maintainers

Package info

Statistics

Security