Open Topics List

Microsoft 365 / Outlook.com

Navigate to My Settings > My Email – Sending Setup to configure settings.

The Mailer field is where you’ll need to choose the mailer you’d like your site to use. To configure the Microsoft 365 / Outlook.com mailer, go ahead and select the 365 / Outlook option.

Now that you’ve chosen the Microsoft 365 / Outlook.com mailer, you should see a new section appear titled Outlook / 365.

To generate the information needed for this section, you’ll need to set up a web application within a Microsoft Azure account.

In order to move forward with the setup process, you’ll need to have a Microsoft Azure account.

Since you most likely already have a Microsoft email account (through Hotmail, Live, Outlook, Microsoft 365, etc), you can simply log into Microsoft Azure with your existing account credentials.

If you need to create a brand new account, you can click this link to sign up for a free Microsoft Azure account.

Note: The email you use for your Azure account must be a Microsoft-based email address that includes email sending permissions. This account email must also be the email address you’d like to use as the From Email on your website.

Next, you’ll need to open the Azure Portal, if you’re not automatically redirected.

Once the Azure Portal is open, type App registrations in the search bar at the top of the page.

Next, you’ll see a dropdown menu with a list of services. Go ahead and click on App registrations.

At the top of the App Registrations page, you’ll need to select the + New Registration option.

In the app registration form, here are the details you’ll need to fill out:

  • Name: This is only for your personal organization, so we recommend naming it something like “Mail SMTP: yourdomain.com”.
  • Supported account types: Select Accounts in any organizational directory and personal Microsoft accounts.

Note: For some Microsoft account types, you may only see the Accounts in any organizational directory (Any Azure AD – Multitenant) option. Go ahead and select this option if the Accounts in any organizational directory and personal Microsoft accounts option doesn’t appear for your account type.

  • Redirect URI: For the first dropdown, leave this set to Web. Then for the second field, you’ll need to copy this value from your Mail SMTP settings.

In order to find the Redirect URI, you’ll need to switch back to the tab or window where you left your site’s Mail SMTP settings open. Under the Outlook / 365 section, you’ll see a field named Redirect URI.

You’ll need to copy this value, then paste it into your Microsoft Azure app registration form. Be sure to still keep both windows/tabs open in your browser, as we’ll continue to switch between the two.

When you’re ready, click the Register button to proceed.

Note: After you’ve registered your application, be sure to double-check your Supported account types and Redirect URI, located under the Authentication tab.

As soon as this registration form is submitted, you’ll be redirected to the Overview page. Here, you’ll find your Application (client) ID. Go ahead and copy this value.

Once you have the Application (client) ID copied, you’ll need to paste this full value into your Mail SMTP settings, in the field labeled Application ID

Next, we’ll need to generate a password for this app. To do that, click on Certificates & secrets in the left sidebar.

On this screen, skip down to the Client secrets section. Then, select + New client secret.

An overlay will appear, and here you’ll need to fill out a short form:

  • Description: This name is only for your own use, so we recommend a logical and simple name such as app_password.
  • Expires: 24 months

After you submit the client secret form, the Application Password will be generated. Go ahead and copy the password under the Value section, and head back over to your  Mail SMTP settings.

Once you’ve returned to the tab or window where your settings are still open, paste this value into the Application Password field.
Set Up API Permissions
Now that you’ve got both the Application ID and Application password filled out in  Mail SMTP, the next step is to set up API permissions. To get started, you’ll need to click on API permissions in the white left menu.

Then, click on the + Add a permission option.

This will open a page titled Request API Permissions. Here, you’ll need to click the large top option named Microsoft Graph.

You’ll only need to fill out a couple pieces of information on this page:

  • What type of permissions does your API require: Choose the option named Delegated permissions
  • Select permissions: Type in send. Then, from the options that appear, check Mail.Send.Shared.

When you’re ready, click the Add permissions button to proceed.

Next, you’ll need to go through this permissions process once more in a slightly different way. To do this, go ahead and click on + Add a permission again, followed by the Microsoft Graph option.

Here are the new details you’ll need for this additional set of permissions:

  • What type of permissions does your API require: Choose the option named Application permissions.
  • Select permissions: Type in send. Then, from the options that appear, check Mail.Send.

Once again, click the Add permissions button when you’re ready to proceed.

Note: If you are using a Microsoft 365 email, you may also need to grant admin permissions for your app. For more details on how to set this up, please check out Microsoft’s tutorial on granting admin consent for Enterprise apps.

Now that your API permissions are all set in Microsoft’s system, we can finish up the configuration in Mail SMTP.

Back in the Mail SMTP settings, you should now have all fields filled out. After checking this over, you can click Save Settings at the bottom of the page.

After you’ve saved the settings, you’ll need to scroll down to the Authorization setting. You should now see a button labeled Allow plugin to send emails using your Microsoft account.

As soon as you click this button, you should be redirected to a Microsoft permissions form.

At the bottom of this form, click Yes.

Next, you will be redirected back to your Mail SMTP settings. At the top of these settings, you should see a notification letting you know that you’ve successfully connected your Microsoft account.

Related Knowledge Base Posts