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

 New object("mailType"; "Microsoft"))

mail Folders

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

// Collection with all the mail folder directly under the root folder

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:


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


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 


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


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

Fabrice Mainguené
• Product Owner •Fabrice Mainguené joined 4D Program team in November, 2016. As a Product Owner, he is in charge of writing the user stories then translating it to functional specifications. His role is also to make sure that the feature implementation delivered is meeting the customer need.After obtaining a Bachelor degree in Computer Science at CNAM, Fabrice joined a small software publishing company as a Windev developer. Then he worked for different companies in industry and trade areas as a Windev and web developer as well as technical advisor on new features.