Microsoft 365 IMAP: OAuth2 Login and Read-Only Inbox
See more IMAP Examples
Authenticate to outlook.office365.com:993 using XOAUTH2, then EXAMINE the Inbox without changing read flags. This is Exchange Online work/school access: the mailbox must permit IMAP and the app must satisfy tenant consent and access policy. Basic authentication and app passwords cannot restore removed IMAP Basic authentication.
Personal Outlook.com uses the same IMAP server, but requires personal-account delegated authorization and IMAP enabled in Outlook.com settings. To use it here, select that mailbox address and load qa_data/tokens/hotmail.json from the personal-account PKCE example. Application-only client credentials are an Exchange Online organizational scenario, not personal Outlook.com authorization.
First authorize the account with https://outlook.office.com/IMAP.AccessAsUser.All and offline_access, then refresh the access token when needed. This example reads qa_data/tokens/office365.json from a private working directory. Microsoft Graph permissions such as Mail.Send or Mail.Read do not authorize these mail protocols. Do not print tokens or authentication logs.
Microsoft reference documentation
Chilkat Classic ASP Downloads
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body>
<%
success = 0
' Assumes Chilkat is unlocked. See Global Unlock Sample.
set token = Server.CreateObject("Chilkat.JsonObject")
success = token.LoadFile("qa_data/tokens/office365.json")
If (success <> 1) Then
Response.Write "<pre>" & Server.HTMLEncode( "Could not read qa_data/tokens/office365.json from the private working directory.") & "</pre>"
Response.End
End If
If ((token.JsonTypeOf("access_token") <> 1) Or (token.StringOfEquals("access_token","",1) = 1)) Then
Response.Write "<pre>" & Server.HTMLEncode( "An OAuth access token is required. Authorize or refresh the account first.") & "</pre>"
Response.End
End If
mailbox = "user@example.com"
set imap = Server.CreateObject("Chilkat.Imap")
imap.Ssl = 1
imap.Port = 993
imap.RequireSslCertVerify = 1
imap.AuthMethod = "XOAUTH2"
success = imap.Connect("outlook.office365.com")
If (success <> 1) Then
Response.Write "<pre>" & Server.HTMLEncode( "Could not establish the Microsoft IMAP TLS connection.") & "</pre>"
Response.End
End If
success = imap.Login(mailbox,token.StringOf("access_token"))
If (success <> 1) Then
success = imap.Disconnect()
Response.Write "<pre>" & Server.HTMLEncode( "IMAP authentication failed. Check the mailbox, token scope, expiry, and account policy.") & "</pre>"
Response.End
End If
' EXAMINE is read-only; no message is downloaded, marked read, moved, or deleted.
success = imap.ExamineMailbox("INBOX")
If (success <> 1) Then
success = imap.Logout()
success = imap.Disconnect()
Response.Write "<pre>" & Server.HTMLEncode( "Could not examine INBOX.") & "</pre>"
Response.End
End If
Response.Write "<pre>" & Server.HTMLEncode( "Messages in INBOX: " & imap.NumMessages) & "</pre>"
success = imap.Logout()
success = imap.Disconnect()
If (success <> 1) Then
Response.Write "<pre>" & Server.HTMLEncode( "The read-only operation completed, but IMAP logout failed.") & "</pre>"
End If
%>
</body>
</html>