Outlook.com POP3: Download a Small Mailbox without Deleting Messages
See more POP3 Examples
Use OAuth2 and FetchAll(true,false,0,bundle) to download complete messages into an EmailBundle without issuing DELE. The example refuses a mailbox initially containing more than 25 messages. This count check is a demonstration guard, not a byte limit: individual messages can be large and new mail may arrive between commands. For large or changing mailboxes, fetch by string UIDL individually or in bounded batches.
POP does not expose folders or IMAP read/unread state. A later run can download the same messages again; persist processed UIDLs per account when needed. Downloading is not a delivery acknowledgement and does not mean another client will mark the mail read.
Personal Outlook.com: This includes Microsoft-hosted Outlook.com, Hotmail, and Live mailboxes. Use delegated OAuth2; ordinary passwords and app passwords are not a replacement for Modern Authentication. SMTP uses smtp-mail.outlook.com:587 with STARTTLS; incoming IMAP/POP use outlook.office365.com on ports 993/995 with implicit TLS. Enable POP or IMAP under Settings > Mail > Forwarding and IMAP before using that protocol. See current Outlook.com settings.
First authorize the account with https://outlook.office.com/POP.AccessAsUser.All and offline_access, then refresh the access token when needed. This example reads qa_data/tokens/hotmail.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 PureBasic Downloads
IncludeFile "CkEmailBundle.pb"
IncludeFile "CkJsonObject.pb"
IncludeFile "CkEmail.pb"
IncludeFile "CkMailMan.pb"
Procedure ChilkatExample()
success.i = 0
; Assumes Chilkat is unlocked. See Global Unlock Sample.
token.i = CkJsonObject::ckCreate()
If token.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
success = CkJsonObject::ckLoadFile(token,"qa_data/tokens/hotmail.json")
If success <> 1
Debug "Could not read qa_data/tokens/hotmail.json from the private working directory."
CkJsonObject::ckDispose(token)
ProcedureReturn
EndIf
If (CkJsonObject::ckJsonTypeOf(token,"access_token") <> 1) OR (CkJsonObject::ckStringOfEquals(token,"access_token","",1) = 1)
Debug "An OAuth access token is required. Authorize or refresh the account first."
CkJsonObject::ckDispose(token)
ProcedureReturn
EndIf
mailbox.s = "user@example.com"
mailman.i = CkMailMan::ckCreate()
If mailman.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
CkMailMan::setCkMailHost(mailman, "outlook.office365.com")
CkMailMan::setCkMailPort(mailman, 995)
CkMailMan::setCkPopSsl(mailman, 1)
CkMailMan::setCkRequireSslCertVerify(mailman, 1)
CkMailMan::setCkPopUsername(mailman, mailbox)
CkMailMan::setCkPopPassword(mailman, "")
CkMailMan::setCkOAuth2AccessToken(mailman, CkJsonObject::ckStringOf(token,"access_token"))
success = CkMailMan::ckPop3Connect(mailman)
If success <> 1
Debug "Could not establish the Microsoft POP3 TLS connection."
CkJsonObject::ckDispose(token)
CkMailMan::ckDispose(mailman)
ProcedureReturn
EndIf
success = CkMailMan::ckPop3Authenticate(mailman)
If success <> 1
CkMailMan::ckPop3EndSessionNoQuit(mailman)
Debug "POP3 authentication failed. Check the token, mailbox, POP setting, and account policy."
CkJsonObject::ckDispose(token)
CkMailMan::ckDispose(mailman)
ProcedureReturn
EndIf
; FetchAll holds the mailbox contents in memory: only use it for a known small mailbox.
count.i = CkMailMan::ckCheckMail(mailman)
If (count < 0) OR (count > 25)
CkMailMan::ckPop3EndSessionNoQuit(mailman)
Debug "Could not count messages or the mailbox exceeds this example's 25-message limit."
CkJsonObject::ckDispose(token)
CkMailMan::ckDispose(mailman)
ProcedureReturn
EndIf
bundle.i = CkEmailBundle::ckCreate()
If bundle.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
; keepOnServer=true prevents DELE; headersOnly=false retrieves complete MIME messages.
success = CkMailMan::ckFetchAll(mailman,1,0,0,bundle)
If success <> 1
CkMailMan::ckPop3EndSessionNoQuit(mailman)
Debug "Could not download the messages."
CkJsonObject::ckDispose(token)
CkMailMan::ckDispose(mailman)
CkEmailBundle::ckDispose(bundle)
ProcedureReturn
EndIf
; Check completeness as well as the method result. Another client can change the mailbox.
If CkEmailBundle::ckMessageCount(bundle) < count
CkMailMan::ckPop3EndSessionNoQuit(mailman)
Debug "Downloaded fewer messages than the initial count. Check for retrieval errors or mailbox changes."
CkJsonObject::ckDispose(token)
CkMailMan::ckDispose(mailman)
CkEmailBundle::ckDispose(bundle)
ProcedureReturn
EndIf
email.i = CkEmail::ckCreate()
If email.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
i.i = 0
While (i < CkEmailBundle::ckMessageCount(bundle))
success = CkEmailBundle::ckEmailAt(bundle,i,email)
If success <> 1
CkMailMan::ckPop3EndSessionNoQuit(mailman)
Debug "Could not read a downloaded message."
CkJsonObject::ckDispose(token)
CkMailMan::ckDispose(mailman)
CkEmailBundle::ckDispose(bundle)
CkEmail::ckDispose(email)
ProcedureReturn
EndIf
Debug "Subject: " + CkEmail::ckSubject(email)
i = i + 1
Wend
success = CkMailMan::ckPop3EndSession(mailman)
If success <> 1
Debug "Messages were downloaded, but closing the POP session failed."
CkJsonObject::ckDispose(token)
CkMailMan::ckDispose(mailman)
CkEmailBundle::ckDispose(bundle)
CkEmail::ckDispose(email)
ProcedureReturn
EndIf
Debug "Messages downloaded without deletion: " + Str(CkEmailBundle::ckMessageCount(bundle))
CkJsonObject::ckDispose(token)
CkMailMan::ckDispose(mailman)
CkEmailBundle::ckDispose(bundle)
CkEmail::ckDispose(email)
ProcedureReturn
EndProcedure