Drupal is a registered trademark of Dries Buytaert

This module provides a lightweight transport layer to use Symfony Mailer with Microsoft Graph API. This makes it possible to send mails using e.g. Microsoft Office 365.

It uses the Client credentials provider workflow with client secret to authenticate with Microsoft Graph API.

For a full description of the module, visit the project page.

Submit bug reports and feature suggestions, or track changes in the issue queue.

Requirements

This module requires the following modules:

You'll need an application in Microsoft Entra granting the permission Mail.Send and providing the required credentials: client id, client secret and tenant id.

Installation

Install as you would normally install a contributed Drupal module. For further information, see Installing Drupal Modules.

Configuration

  1. Enable the module at Administration > Extend.
  2. Visit the transport configuration page at Administration > Configuration > System > Mailer > Mailer Transport.
  3. Add a new transport and select "MS Graph API" as the transport type. Enter the client credentials. The "DSN" transport type is not supported, as the list of available DSN transports is hardwired in Symfony Mailer.

Limitations

  • This module is strictly limited to providing a minimal transport layer. It does not modify the outgoing mail in any way.
  • While the sender address is taken from the sent mails, the mails are always sent from the primary smtp address configured in the Microsoft Entra application. This is a limitation of the Microsoft Graph API. If you manage to figure out how to work around this e.g. using aliases, shared mailboxes or proxy addresses, please open an issue and let us know.

Similar modules

Maintainers

Credits

Activity

Total releases
4
First release
Mar 2025
Latest release
1 month ago
Release cadence
103 days
Stability
75% stable

Release Timeline

Releases

Version Type Release date
1.0.2 Stable Jan 31, 2026
1.0.1 Stable May 13, 2025
1.0.0 Stable Apr 14, 2025
1.0.x-dev Dev Mar 27, 2025