How to Set Up the Outlook Mailer in Raw Beauty Space

Want to use your Outlook account to receive and send email notifications from your site? The Outlook mailer for RBS SMTP lets you securely use Microsoft’s API to authenticate your site’s emails.

In this tutorial, we’ll show you every step needed to set up the Microsoft Outlook mailer in RBS SMTP.

  1. What is the Outlook Mailer?
  2. Getting Started with RBS SMTP
  3. Configuring a Microsoft Azure Account
  4. Saving Settings and Authorizing RBS SMTP
  5. Sending a Test Email
  6. Frequently Asked Questions

Requirements: While this mailer setup does not require use of any paid services, Microsoft will require that you enter a credit card to set up an account (to reduce spam signups).


What is the Outlook Mailer?

Microsoft offers not only email address/inbox services, but also a tool to improve the deliverability of your emails. They do this through an API, which means that you don’t have to enter any sensitive login details into your  admin area (more secure than traditional SMTP).

Microsoft offers this service free to anyone with one of their email accounts (example@outlook.com, example@live.com, or an Office 365 email address).

Also importantly, the Outlook mailer can send up to 10,000 emails per minute. That’s much higher than the limits on most other mailers. The tradeoff, though, is that Microsoft’s setup requirements are more complex than most other mailer options in RBS SMTP.

If this mailer sounds like a good fit for your site, then let’s get started!

1. Getting Started with RBS SMTP

You can find settings under Forms » SMTP settings. At the top of the Settings page, you’ll see a From Email and From Name options. You can skip both of these settings, as anything here will be overridden by the settings within your Outlook account (later on, you’ll notice that these fields both end up disabled).

 

We recommend checking the optional Return Path checkbox to Set the return-path to match the From Email. With this enabled, you’ll be emailed if any messages bounce as a result of issues with the recipient’s email.

Next, you’ll need to scroll to the Mailer field and select the Outlook option.

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

To generate the information needed for this section, you’ll need to set up a web application within a Microsoft Azure account. This process doesn’t require any coding, and we’ll show you exactly what to do in the next step.

Be sure to keep these RBS SMTP settings open in a separate tab or window, as you’ll come back to them soon.

2. Configuring 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, Office 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 sign up for a free Microsoft Azure account.

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

Next, you’ll need to open the Azure Portal.

Create an Application ID

Once the Azure Portal is open, click on All services in the left sidebar.

Click on All Services option in Microsoft account

Next, you’ll see a list of categories. Go ahead and click on Identity. When an additional column appears, click on App registrations.

Select Identity and then App Registrations

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

Click on New Registration

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 “RBS SMTP: yourdomain.com”.
  • Supported Account Types: Select Accounts in any organizational directory and personal Microsoft accounts.

  • 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 RBS SMTP settings (see below).

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

Copy Redirect URI from WP Mail SMTP settings

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.

Finish app registration form in Microsoft

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

As soon as this registration form is submitted, you should see a page that includes Application (client) ID.

Copy Application ID from Microsoft

You’ll need to copy this full value into your RBS SMTP settings, in the field labeled Application ID.

Paste Application ID into WP Mail SMTP settings

Create an Application Password

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

Open Certificates and Secrets menu item

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

Create a new client secret in Microsoft settings

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: Never

Example form to add a client secret in Microsoft

After you submit the client secret form, the Application Password will be generated.

Copy client secret from Microsoft account

You’ll need to copy this into your RBS SMTP settings. Once you’ve returned to the tab or window where these settings are still open, paste this value into the Application Password field.

Paste client secret into Application Password field

Set Up API Permissions

Now that you’ve got both the Application ID and Application password filled out in RBS 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.

Add a permission to your Microsoft API

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

Click on the Microsoft Graph option

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

Choose delegated permissions for Microsoft API

  • Select permissions: Type in send. Then, from the options that appear, check Mail.Send.Shared.

Provide mail sending permissions

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 again click on + Add a permission, 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.

    Add application permissions in Microsoft

  • Select permissions: Type in send. Then, from the options that appear, check Mail.Send.

Add mail sending permissions to app

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

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

3. Saving Settings and Authorizing RBS SMTP

Back in the RBS 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, 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.

Provide authorization for Microsoft account

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

Microsoft permissions request form

At the bottom of this form, click Yes.

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

 

4. Sending a Test Email

Now that you’ve completed the setup process, you’re ready to send a test email. To do this, click on the Email Test tab in your site’s RBS SMTP settings.

Once the Test Email tab is open, you’ll need to enter a valid email address and click the Send Email button. Be sure to use an email address you have access to so you can confirm the email is delivered.

When the test message has been sent, you’ll see a success message at the top of this tab.

You should also soon receive a test email at the email address you entered.

That’s it! You’ve now set up RBS SMTP’s Outlook mailer on your site.