symfony/microsoft-graph-mailer

Symfony Microsoft Graph Mailer Bridge

8.0.x-dev 2025-08-07 22:35 UTC

Requires

• php: >=8.2
• symfony/clock: ^7.4|^8.0
• symfony/http-client: ^6.4|^7.0|^8.0
• symfony/mailer: ^7.4|^8.0

MIT

• Bob van de Vijver
• Kevin Nguyen
• The Coding Machine
• Symfony Community

README

Provides Microsoft Graph API Email integration for Symfony Mailer.

Prerequisites

You will need to:

• Register an application in your Microsoft Azure portal,
• Grant this application the Microsoft Graph Mail.Send permission,
• Create a secret for that app.

Configuration example

# MAILER
MAILER_DSN=microsoftgraph+api://CLIENT_APP_ID:CLIENT_APP_SECRET@default?tenantId=TENANT_ID

This will default to graph.microsoft.com for the Graph API and login.microsoftonline.com for authentication.

If you need to use third parties operated or specific regions Microsoft services (China, US Government, etc.), you can specify the Graph Endpoint and the Auth Endpoint explicitly.

# MAILER e.g. for China
MAILER_DSN=microsoftgraph+api://CLIENT_APP_ID:[e-mail]?tenantId=TENANT_ID&authEndpoint=login.partner.microsoftonline.cn

The exact URLs can be found in the Microsoft documentation:

• Graph Endpoints
• Auth Endpoints

You can also specify to not save the messages to sent items using the noSave parameter:

# MAILER
MAILER_DSN=microsoftgraph+api://CLIENT_APP_ID:CLIENT_APP_SECRET@default?tenantId=TENANT_ID&noSave=true

Troubleshooting

Beware that the sender email address needs to be an address of an account inside your tenant.

Resources

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