symfony / scaleway-mailer

v8.1.0 2026-05-29 05:06 UTC

Requires

• php: >=8.4.1
• symfony/mailer: ^7.4|^8.0

Requires (Dev)

• symfony/http-client: ^7.4|^8.0

MIT

• Fabien Potencier
• Symfony Community

Published on Packagist.org on 2026-05-29 08:51 UTC

README

Provides Scaleway Transactional Email integration for Symfony Mailer.

Configuration example:

# SMTP
MAILER_DSN=scaleway+smtp://PROJECT_ID:API_KEY@default

# API
MAILER_DSN=scaleway+api://PROJECT_ID:API_KEY@default

where:

• PROJECT_ID is your Scaleway project ID
• API_KEY is your Scaleway API secret key

Webhook

Scaleway delivers email events through Scaleway Topics and Events, which signs each message instead of sharing a secret. That's why the secret option is not needed for this provider.

The bridge verifies the signature with the certificate referenced by the SigningCertURL field of the message, after checking that the Scaleway certificate authority bundled with the bridge issued it. Fetching the certificate requires the HttpClient component. In Symfony applications, the certificate is cached in the cache.app pool.

The first time Scaleway calls the endpoint, it sends a subscription confirmation message and the bridge confirms it automatically. That message contains no email event, so your application responds to it with an HTTP 406 status code. This is expected: the subscription is confirmed by the request the bridge makes to Scaleway, not by that response.

Sponsor

This package is looking for a backer.

Help Symfony by sponsoring its development!

Resources

• Contributing
• Report issues and send Pull Requests in the main Symfony repository