{"id":37231783,"url":"https://github.com/craftcms/microsoft-graph-mailer","last_synced_at":"2026-01-15T03:45:51.570Z","repository":{"id":332405092,"uuid":"1068519434","full_name":"craftcms/microsoft-graph-mailer","owner":"craftcms","description":"Microsoft Graph Mailer adapter for Craft CMS","archived":false,"fork":false,"pushed_at":"2025-12-09T18:33:28.000Z","size":52,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"1.x","last_synced_at":"2026-01-13T19:32:02.898Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/craftcms.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-02T14:03:03.000Z","updated_at":"2025-12-09T18:27:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/craftcms/microsoft-graph-mailer","commit_stats":null,"previous_names":["craftcms/microsoft-graph-mailer"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/craftcms/microsoft-graph-mailer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/craftcms%2Fmicrosoft-graph-mailer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/craftcms%2Fmicrosoft-graph-mailer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/craftcms%2Fmicrosoft-graph-mailer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/craftcms%2Fmicrosoft-graph-mailer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/craftcms","download_url":"https://codeload.github.com/craftcms/microsoft-graph-mailer/tar.gz/refs/heads/1.x","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/craftcms%2Fmicrosoft-graph-mailer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28442342,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-15T00:55:22.719Z","status":"online","status_checked_at":"2026-01-15T02:00:08.019Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-15T03:45:50.953Z","updated_at":"2026-01-15T03:45:51.555Z","avatar_url":"https://github.com/craftcms.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"./src/icon.svg\" width=\"100\" height=\"100\" alt=\"Microsoft Graph icon\"\u003e\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eMicrosoft Graph Mailer for Craft CMS\u003c/h1\u003e\n\nThis plugin provides a [Microsoft Graph](https://learn.microsoft.com/en-us/graph/overview) mailer adapter for Craft CMS.\n\n## Requirements\n\nThis plugin requires Craft CMS 5.8.0 or later, and PHP 8.2 or later.\n\n## Installation\n\nYou can install this plugin from the Plugin Store or with Composer.\n\n#### From the Plugin Store\n\nGo to the Plugin Store in your project’s Control Panel and search for “Microsoft Graph Mailer”. Then press “Install”.\n\n#### With Composer\n\nOpen your terminal and run the following commands:\n\n```bash\n# go to the project directory\ncd /path/to/my-project.test\n\n# tell Composer to load the plugin\ncomposer require craftcms/microsoft-graph-mailer\n\n# tell Craft to install the plugin\n./craft plugin/install microsoft-graph-mailer\n```\n\n## Microsoft Prerequisites\n- Microsoft Azure Portal account\n- Microsoft 365 licensed mailbox\n\n## Microsoft Setup\n- Log in to your [Azure Portal account](https://portal.azure.com).\n- Navigate to **Azure Active Directory (Entra)**.\n\n### 1. Create the app\n- Go to **Manage** → **App registrations** and press **New registration**.\n- Give your app a **Name**.\n- Under **Supported account types**, select **Accounts in this organizational directory only (Single tenant)**.\n- Press **Register**. The app will be created, and you’ll be taken to its overview page.\n\n### 2. Create credentials\n- Beside **Client credentials**, press **Add a certificate or secret**.\n- Under **Client secrets**, press **New client secret**. Give it a description and preferred expiration timeframe, then press **Add**.\n- 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.\n\n\u003e [!NOTE]\n\u003e It won’t be possible to re-retrieve the secret’s value once you’ve left the page.\n\n### 3. Grant permissions\n- Go to **Manage** → **App registrations** → **_[your app]_** → **Manage** → **API permissions** and press **Add a permission**.\n- Under **Microsoft APIs**, select **Microsoft Graph**.\n- Select **Application permissions** (not Delegated).\n- Select the checkbox for **Mail** → **Mail.Send**.\n- Press **Add permissions**. The permission will show in the table with a status of “Not granted for _[your organization name]_”.\n- 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]_”.\n\n## Plugin Setup\n\nOnce Microsoft Graph Mailer is installed:\n\n1. Go to **Settings** → **Email**.\n2. 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.\n3. Enter your Azure App **Client ID** (Application (client) ID).\n4. Enter your Azure App **Client Secret** (secret Value).\n5. Enter your Azure App **Tenant ID** (Directory (tenant) ID).\n6. If you need to use graph and auth endpoints other than the default, you can fill out **Graph Endpoint** and **Auth Endpoint** fields.\n7. If you want to save the messages to sent items, toggle **Save to sent items** on.\n8. Click **Save**.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcraftcms%2Fmicrosoft-graph-mailer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcraftcms%2Fmicrosoft-graph-mailer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcraftcms%2Fmicrosoft-graph-mailer/lists"}