supersendtx/symfony-mailer

Symfony Mailer transport for the SuperSend TX transactional email API

v0.8.3 2026-08-04 05:15 UTC

Requires

• php: >=8.1
• supersendtx/supersendtx: ^0.8.2
• symfony/mailer: ^6.2|^7.0
• symfony/mime: ^6.2|^7.0

Requires (Dev)

• phpunit/phpunit: ^11.0

MIT

• SuperSend TX

• mailer
• symfony
• email
• transactional
• symfony-mailer
• supersend
• supersendtx

Published on Packagist.org on 2026-08-04 06:01 UTC

README

Symfony Mailer transport for SuperSend TX transactional email (HTTP API).

Install

composer require supersendtx/symfony-mailer

export SUPERSENDTX_API_KEY=stx_your_key_here

Usage

use SuperSendTX\Client;
use SuperSendTX\Symfony\Transport\SuperSendTXTransport;
use Symfony\Component\Mailer\Mailer;
use Symfony\Component\Mime\Email;

$mailer = new Mailer(new SuperSendTXTransport(new Client(getenv('SUPERSENDTX_API_KEY'))));

$email = (new Email())
    ->from('[e-mail]')
    ->to('[e-mail]')
    ->subject('Welcome')
    ->html('<p>Welcome.</p>');

$mailer->send($email);

DSN

use SuperSendTX\Symfony\Transport\SuperSendTXTransportFactory;
use Symfony\Component\Mailer\Transport;

$transport = Transport::fromDsns(
    'supersendtx+api://%s@default',
    null,
    null,
    null,
    [new SuperSendTXTransportFactory()],
);
// Or: supersendtx://default?api_key=stx_…

In Symfony Framework, register SuperSendTXTransportFactory as a mailer.transport_factory service and set:

# config/packages/mailer.yaml
framework:
  mailer:
    dsn: 'supersendtx+api://%env(SUPERSENDTX_API_KEY)%@default'

Headers

Header	Purpose
X-SuperSendTX-Tag	name=value tag (repeatable)
X-SuperSendTX-Idempotency-Key	Idempotency key
X-SuperSendTX-Scheduled-At	ISO 8601 schedule

Docs

https://docs.supersendtx.com/frameworks/symfony

License

MIT