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

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

PureBasic
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