Microsoft Office 365 Email with Graph API

Owned by Karl Henselin
Last updated: about 2 hours ago by Chandresh Patel
2 min read

HTTPS Required – Microsoft mandates that the requesting application be hosted over HTTPS. A FlexDeploy installation using only HTTP will not be able to support Microsoft OAuth.

Prerequisites

See Creating and connecting to an Office 365 Graph email application compatible with FlexDeploy for directions to create a suitable application in Azure and connect it with FlexDeploy. Then resume with next section when ready.

Update FlexDeploy System Settings

Outgoing Email Settings

Next, go to System Settings → Email Settings - Outgoing Email Settings, and select OAuth for the Auth Type.

  1. User Name - This must match the user who completed the Authorize action for Microsoft Azure application on the System Settings - Integration Settings page. This user name will be used for Microsoft Graph API.

  2. OAuth Application - Choose the OAuth application you just created.

  3. From Address - The user must have permission to send from this address, or it won’t work. This can be a shared mailbox.

image-20250111-175558.png

Incoming Email Settings

If you are using the same user for outgoing and incoming emails (recommended) then you can leave the top of the section titled Incoming Email Settings mostly blank. Follow notes provided on Description of each setting.

image-20250111-180102.png

Email Reply Options

  1. Email Reply Folder - This is the folder (can be a shared folder) that will have all mail processed and deleted from it by FlexDeploy. You cannot use the same folder for dev and prod FlexDeploy servers, as one of the servers will read and delete the mail, and the other will not get the mail. You could use one user account, as long as you use separate folders. Inbox is likely the value that you want. However, if you use Inbox, and test it with your personal email address, all your email will be irrecoverably lost.

  2. Approval Reply Address - This defaults to the same as the SMTP from address, and works with shared mailboxes. When users click reply to the emails FlexDeploy send, it should be routed into the folder that you specified above.

Validate

Once authorization is complete, you can test the configuration by clicking on the Test Email Configuration button located at the bottom next to Save.

  • Sends a test email to the logged in user's email address to validate the SMTP OAuth settings.

  • Reads the inbox of the Approval Reply Address to validate the IMAP OAuth settings.

The following macros are not currently supported in the footer:
  • style