Contact usRequest a demo

Outgoing emails with Microsoft Office 365

Unblu can be configured to send emails in a number of situations. If your organization uses Microsoft Office 365, this requires you to:

If your organization doesn’t use Microsoft Office 365, follow the SMTP configuration instructions in the article Outgoing emails instead.

Register an app and set up mail credentials

Before you can configure Unblu to use Microsoft Office 365 for outgoing emails, you must register an app for Unblu in the Azure portal and give it the necessary permissions.

  1. In your organization’s Azure portal, navigate to the Azure Service App registrations and create a new app registration. Give it a meaningful name such as unblu-outgoing-email.

  1. On the overview page of the app registration you just created, copy the Application (client) ID and Directory (tenant) ID. You need these values when you configure Unblu.

  2. Select API permissions in the navigation sidebar, then click Add a permission.

  3. In the panel that opens on the right, select Microsoft Graph, then select Application permissions.

  4. Enter mail.send in the search field and check the Mail.Send option when it appears.

    For more information on this permission, refer to Mail.Send entry in the Microsoft Graph permissions reference.

  5. Click Add permissions to complete the process.

The Mail.Send permission you added above requires admin consent. Make sure someone within your organization with the the required role reviews your consent request. If they don’t approve the request, Unblu can’t send emails through Microsoft Office 365.

Once admin consent has been granted for the Mail.Send permission, the app can send emails from any mailbox in your organization that Azure has access to. How to restrict which mailboxes the app can use is beyond the scope of this article. For more information, refer to the Microsoft article Limiting application permissions to specific Exchange Online mailboxes.

Next, you must create client credentials to give the app you registered to access MS Office 365:

  1. In the Essentials section on the overview page of the app registration you just created, click Add a certificate or secret next to Client credentials.

  2. If necessary, select Client secrets, then click New client secret.

  3. Give the secret a meaningful description and select an expiration time in accordance with your organization’s policies, then click Add.

    Make sure to renew the secret before it expires, or Unblu won’t be able to send emails.
  1. Copy the Value of your client secret and save it with the IDs you made a note of above.

    This is the only opportunity you have to see the value of the client secret you created. If you don’t make a note of it now, you have to create a new one.

You’ve finished setting everything up in the Azure portal. Now you can configure Unblu.

Configure Unblu to use Microsoft Office 365 for outgoing emails

Before you start configuring Unblu, make sure you have the following information to hand:

  • The Application (client) ID

  • The Directory (tenant) ID

  • The Value of the client secret

If you followed the instructions in the previous section, you should have made a note of both IDs and the client secret value.

Next, you must decide which scope you want to add the configuration for Microsoft Office 365 to. Which scope you choose determines which configuration properties you must set.

If you set configuration property com.unblu.mail.msoffice365.account.enabled to true on an account, the global settings are ignored. Instead, Unblu uses the account-level settings.

If you have multiple accounts, most of which share the same configuration, you can set the configuration property to true on the accounts that have a different configuration. That way, the other accounts can share the global configuration thanks to the configuration cascade.

Once you’ve made you decision regarding the scope, set com.unblu.mail.provider to MSOFFICE365 in the appropriate scope. Then proceed with the remaining configuration properties.

GLOBAL settings

To configure MS Office 365 in the GLOBAL scope or the configuration properties file, set the following configuration properties:

ACCOUNT settings

To configure MS Office 365 in the ACCOUNT scope, set the following configuration properties:

See also

  • If your organization doesn’t use Microsoft Office 365 for email, follow the SMTP configuration instructions in the article Outgoing emails.

  • For information on the types of email Unblu can send and how to configure their content, refer to the Emails section of Outgoing emails.