Microsoft 365: Receive Emails with the Microsoft Graph API

To access the data in Microsoft 365 like emails, Microsoft is deprecating Basic authentication for IMAP and POP3 and is increasingly promoting the Graph API.

4D v19 R3 brought the 4D Netkit component to manage the OAuth 2.0 connection and the mail sending through the Graph API.

In the v19 R8, we add new commands to receive emails and list your mailbox folders.

HDI Office365 Get Mails

Account connection

Before starting, we will create the OAuth2 connection object and the Office 365 object.

var $oAuth2: cs.NetKit.OAuth2Provider
var $office365 : cs.NetKit.Office365

$oAuth2:=cs.NetKit.OAuth2Provider.new($param)
$office365:=cs.NetKit.Office365.new($oAuth2;\
 New object("mailType"; "Microsoft"))

mail Folders

You can get the mail folder collection directly under the root folder by using the .getFolderList() function:

$folderList:=$office365.mail.getFolderList()
// Collection with all the mail folder directly under the root folder
$folders:=$folderList.folders

You get a collection that contains, for each folder, helpful information such as the folder name, id, number of emails, and so :

If you have some folders with children folders, you need to call the .getFolderList() function using the folder id as a parameter to have the details of the folders:

$childrenList:=$office365.mail.getFolderList($folders[8].id)

Download emails

You can get the mails of your mailbox by using the .getMails() function. For example, if you want to retrieve all the mails present in the Inbox folder:

$param:=New object
$param.folderId:=$folder[1].id  // inbox folder

$mails:=$office365.mail.getMails($param)

When the selected folder is a folder created by default for users, instead of using the corresponding folder id value, for convenience, you can use the well-known folder names (archive,  drafts, inbox, junkemail,  sentitems, and so… ). So you can write the example below:

$param:=New object 
$param.folderId:="inbox"

$mails:=$office365.mail.getMails($param)

If you just need to download a specific email, you can use the .getMail() function and pass it the id of the email:

$mail:=$office.mail.getMail($mailId)

Check out this feature with the HDI and the documentation for more details!