Drupal is a registered trademark of Dries Buytaert
Protected Pages 3.0.0 Major update available for module protected_pages (3.0.0). Commerce Core 3.3.8 Minor update available for module commerce (3.3.8). Search API HTML Element Filter 1.0.7 Minor update available for module search_api_html_element_filter (1.0.7). Layout Builder Reorder 2.0.1 Minor update available for module layout_builder_reorder (2.0.1). Ban 1.1.0 Minor update available for module ban (1.1.0). Field Formatter Range 2.0.0 Major update available for module field_formatter_range (2.0.0). Field Formatter Range 8.x-1.8 Minor update available for module field_formatter_range (8.x-1.8). Varbase Media Header 9.2.1 Minor update available for module varbase_media_header (9.2.1). Search API Solr 4.3.11 Module search_api_solr updated after 14 months of inactivity (4.3.11). Provus Mega Menu Module provus_mega_menu crossed 1,000 active installs.

PHPMailer OAuth2

321 sites No security coverage
View on drupal.org

This module provides basic OAuth2 support for PHPMailer SMTP, currently supporting Azure authentication. It allows you to configure OAuth2 settings and obtain authentication tokens within Drupal to send emails securely.

Looking for new maintainer

See #3365216: PHPMailer OAuth2 Looking for new maintainer.

Overview and configuration

Provides basic OAuth2 support for PHPMailer SMTP.

It currently only supports Azure authentication. Because Microsoft does not support client credentials flow for SMTP (yet), occasional manual updates of the auth and refresh token may be required.

Configuration is at: Config -> System -> PHPMailer OAuth2

Enter your settings and click "Save Configuration". Once it has been saved, click "Get auth token" to get new auth and refresh tokens.

Once enabled, set the Authentication Type within PHPMailer SMTP.

The redirect path to provide to Azure is /phpmailer_oauth2/aad-callback. For example:

https://www.example.com/phpmailer_oauth2/aad-callback

Install with composer.

composer require drupal/phpmailer_oauth2

Other providers

Review the code in the module to find out how it works so you can implement your own provider. This could be a stand-alone module or included within this module.

The PHPMailer library supports league/oauth2-client providers:

As of PHPMailer 6.6.0, the library now accepts anything that implements the OAuthProviderInterface. This includes Google's OAuth classes.

Alternatives

Gmail OAuth2 Client apparently uses OAuth2 Client and integrates with PHPMailer SMTP.

Many email services are recommending the use of their APIs instead of SMTP for sending email. The Pantheon hosting platform also recommends this approach.

There are a few modules for specific services.

Activity

Total releases
3
First release
Oct 2025
Latest release
8 months ago
Releases (12 mo)
3 ▲ from 0
Maintenance
Slowing

Release Timeline

Releases

Version Type Release date
2.0.0-alpha2 Pre-release Oct 21, 2025
2.0.0-alpha1 Pre-release Oct 21, 2025
2.0.x-dev Dev Oct 21, 2025