PHPackages craftcms/microsoft-graph-mailer - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Mail & Notifications](/categories/mail) 4. / 5. craftcms/microsoft-graph-mailer ActiveCraft-plugin[Mail & Notifications](/categories/mail) craftcms/microsoft-graph-mailer =============================== Microsoft Graph Mailer adapter for Craft CMS 1.0.0(5mo ago)021mitPHPPHP >=8.2CI passing Since Dec 9Pushed 5mo agoCompare [ Source](https://github.com/craftcms/microsoft-graph-mailer)[ Packagist](https://packagist.org/packages/craftcms/microsoft-graph-mailer)[ RSS](/packages/craftcms-microsoft-graph-mailer/feed)WikiDiscussions 1.x Synced 1mo ago READMEChangelog (1)Dependencies (5)Versions (2)Used By (0) [![Microsoft Graph icon](./src/icon.svg)](./src/icon.svg) Microsoft Graph Mailer for Craft CMS ==================================== [](#microsoft-graph-mailer-for-craft-cms) This plugin provides a [Microsoft Graph](https://learn.microsoft.com/en-us/graph/overview) mailer adapter for Craft CMS. Requirements ------------ [](#requirements) This plugin requires Craft CMS 5.8.0 or later, and PHP 8.2 or later. Installation ------------ [](#installation) You can install this plugin from the Plugin Store or with Composer. #### From the Plugin Store [](#from-the-plugin-store) Go to the Plugin Store in your project’s Control Panel and search for “Microsoft Graph Mailer”. Then press “Install”. #### With Composer [](#with-composer) Open your terminal and run the following commands: ``` # go to the project directory cd /path/to/my-project.test # tell Composer to load the plugin composer require craftcms/microsoft-graph-mailer # tell Craft to install the plugin ./craft plugin/install microsoft-graph-mailer ``` Microsoft Prerequisites ----------------------- [](#microsoft-prerequisites) - Microsoft Azure Portal account - Microsoft 365 licensed mailbox Microsoft Setup --------------- [](#microsoft-setup) - Log in to your [Azure Portal account](https://portal.azure.com). - Navigate to **Azure Active Directory (Entra)**. ### 1. Create the app [](#1-create-the-app) - Go to **Manage** → **App registrations** and press **New registration**. - Give your app a **Name**. - Under **Supported account types**, select **Accounts in this organizational directory only (Single tenant)**. - Press **Register**. The app will be created, and you’ll be taken to its overview page. ### 2. Create credentials [](#2-create-credentials) - Beside **Client credentials**, press **Add a certificate or secret**. - Under **Client secrets**, press **New client secret**. Give it a description and preferred expiration timeframe, then press **Add**. - Copy the **Application (client) ID**, **Directory (tenant) ID**, and the secret **Value** somewhere safe. You’ll need these values to configure the Craft CMS mailer. Note It won’t be possible to re-retrieve the secret’s value once you’ve left the page. ### 3. Grant permissions [](#3-grant-permissions) - Go to **Manage** → **App registrations** → ***\[your app\]*** → **Manage** → **API permissions** and press **Add a permission**. - Under **Microsoft APIs**, select **Microsoft Graph**. - Select **Application permissions** (not Delegated). - Select the checkbox for **Mail** → **Mail.Send**. - Press **Add permissions**. The permission will show in the table with a status of “Not granted for *\[your organization name\]*”. - Press **Grant admin consent for *\[your organization name\]***. The permission should now show in the table with a status of “Granted for *\[your organization name\]*”. Plugin Setup ------------ [](#plugin-setup) Once Microsoft Graph Mailer is installed: 1. Go to **Settings** → **Email**. 2. Change the **Transport Type** setting to **Microsoft Graph Mailer**. Also, ensure that your System Email Address in your Craft Email Settings matches the licensed mailbox you want to send emails from. 3. Enter your Azure App **Client ID** (Application (client) ID). 4. Enter your Azure App **Client Secret** (secret Value). 5. Enter your Azure App **Tenant ID** (Directory (tenant) ID). 6. If you need to use graph and auth endpoints other than the default, you can fill out **Graph Endpoint** and **Auth Endpoint** fields. 7. If you want to save the messages to sent items, toggle **Save to sent items** on. 8. Click **Save**. ### Health Score 36 — LowBetter than 82% of packages Maintenance72 Regular maintenance activity Popularity9 Limited adoption so far Community8 Small or concentrated contributor base Maturity47 Maturing project, gaining track record Bus Factor1 Top contributor holds 63.6% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 2 Last Release 160d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/3ccdf8b493035de2343c55bd889513e3af5c04d5823482a2b186ad16adb1c3e3?d=identicon)[brandonkelly](/maintainers/brandonkelly) --- Top Contributors [![i-just](https://avatars.githubusercontent.com/u/4500340?v=4)](https://github.com/i-just "i-just (7 commits)")[![brandonkelly](https://avatars.githubusercontent.com/u/47792?v=4)](https://github.com/brandonkelly "brandonkelly (4 commits)") --- Tags mailercmsyii2craftcmsMicrosoft graphmicrosoft-365 ### Embed Badge ![Health badge](/badges/craftcms-microsoft-graph-mailer/health.svg) ``` [![Health](https://phpackages.com/badges/craftcms-microsoft-graph-mailer/health.svg)](https://phpackages.com/packages/craftcms-microsoft-graph-mailer) ``` ### Alternatives [craftcms/contact-form Add a simple contact form to your Craft CMS site 295427.3k17](/packages/craftcms-contact-form)[craftcms/mailgun Mailgun integration for Craft CMS 27226.1k7](/packages/craftcms-mailgun)[craftcms/postmark Postmark adapter for Craft CMS 20182.4k2](/packages/craftcms-postmark)[craftcms/commerce Craft Commerce 243416.9k153](/packages/craftcms-commerce)[craftcms/apple-news Publish Craft CMS entries to Apple News 4223.5k](/packages/craftcms-apple-news)[craftpulse/craft-notifications Send notifications across a variety of delivery channels, including mail and Slack. Notifications may also be stored in a database so they may be displayed in your web interface. 551.2k](/packages/craftpulse-craft-notifications) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)