Email | Configure Microsoft Graph Mailer for WordPress

Register your WordPress website in Entra ID

Steps in this Topic

Video Walkthrough

Please follow along with the video walkthrough below, explaining the steps required to register your WordPress website in Entra ID when planning to send WordPress emails from any Microsoft 365 (Shared) Mailbox using Microsoft Graph.

Prepare Email Sending with Microsoft Graph

  • To begin configuring your WordPress site to send emails using Microsoft Graph, navigate to the plugin’s Mail configuration page.
  • At the top of this page, you’ll find:
    • Links with additional information describing the available features.
    • A link to this written tutorial.
  • You’ll notice that sending emails with Microsoft Graph is currently disabled.
    • You must explicitly enable this feature.
  • Once enabled, your WordPress site will immediately try to send all outgoing emails using Microsoft Graph.
    • Because Microsoft Graph is not yet configured, these emails will fail.
    • For that reason, it’s recommended to enable this feature during a period when your website has little or no visitor activity.
  • To send emails using Microsoft Graph, your website must be registered as an application in Microsoft Entra ID.

Register Your WordPress Site in Microsoft Entra ID

  • Open your browser and go to https://entra.microsoft.com.
    • This gives you access to your Microsoft Entra ID tenant.
  • Navigate to App registrations.
    • From here, you can register a new application for your WordPress website.
  • Click New registration to create a new app.
    • Enter a display name.
    • Select Single tenant as the supported account type, since the plugin requires a user account in your Entra ID to send emails via Microsoft Graph.
  • As part of the app registration, you must define a redirect URI:
    • Return to the plugin’s Mail configuration page in WordPress.
    • Scroll down until you see the proposed redirect URI.
    • Copy this value.
  • Back in Microsoft Entra ID:
    • Add the copied value as a Redirect URI.
    • Select Web as the platform.
    • Paste the URI and complete the app registration.
  • Your WordPress website is now registered in Microsoft Entra ID and ready for the next configuration steps.

Please note The website address https://staging.wpo365connect.com/ is used as an example here and is the address of the website used in this video. You will configure your own website and therefore you should not use https://staging.wpo365connect.com.


Copying required IDs to the WPO365 plugin configuration

  • After registering your website in Microsoft Entra ID, you are provided with an Application (Client) ID.
  • Copy the Application ID from the App Registration’s Overview page.
  • Go back to the Mail configuration page of the WPO365 plugin in WordPress.
    • Paste the Application ID into the corresponding field.
  • The Application ID alone is not sufficient. You also need to configure the Directory (Tenant) ID to identify your Microsoft Entra tenant.
  • Copy the Directory (Tenant) ID from the same Overview page of your App Registration.
  • Paste the ID into the corresponding field on the plugin’s Mail configuration page.