Sample code for 30+ languages & platforms
Classic ASP Requires Chilkat v11.0.0+

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

Classic ASP
<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>