Sample code for 30+ languages & platforms
Delphi ActiveX 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 Delphi ActiveX Downloads

Delphi ActiveX
var
success: Integer;
token: TChilkatJsonObject;
mailbox: WideString;
mailman: TChilkatMailMan;
count: Integer;
bundle: TChilkatEmailBundle;
email: TChilkatEmail;
i: Integer;

begin
success := 0;

//  Assumes Chilkat is unlocked. See Global Unlock Sample.

token := TChilkatJsonObject.Create(Self);
success := token.LoadFile('qa_data/tokens/hotmail.json');
if (success <> 1) then
  begin
    Memo1.Lines.Add('Could not read qa_data/tokens/hotmail.json from the private working directory.');
    Exit;
  end;
if ((token.JsonTypeOf('access_token') <> 1) or (token.StringOfEquals('access_token','',1) = 1)) then
  begin
    Memo1.Lines.Add('An OAuth access token is required. Authorize or refresh the account first.');
    Exit;
  end;
mailbox := 'user@example.com';
mailman := TChilkatMailMan.Create(Self);
mailman.MailHost := 'outlook.office365.com';
mailman.MailPort := 995;
mailman.PopSsl := 1;
mailman.RequireSslCertVerify := 1;
mailman.PopUsername := mailbox;
mailman.PopPassword := '';
mailman.OAuth2AccessToken := token.StringOf('access_token');
success := mailman.Pop3Connect();
if (success <> 1) then
  begin
    Memo1.Lines.Add('Could not establish the Microsoft POP3 TLS connection.');
    Exit;
  end;
success := mailman.Pop3Authenticate();
if (success <> 1) then
  begin
    mailman.Pop3EndSessionNoQuit();
    Memo1.Lines.Add('POP3 authentication failed. Check the token, mailbox, POP setting, and account policy.');
    Exit;
  end;
//  FetchAll holds the mailbox contents in memory: only use it for a known small mailbox.
count := mailman.CheckMail();
if ((count < 0) or (count > 25)) then
  begin
    mailman.Pop3EndSessionNoQuit();
    Memo1.Lines.Add('Could not count messages or the mailbox exceeds this example''s 25-message limit.');
    Exit;
  end;
bundle := TChilkatEmailBundle.Create(Self);
//  keepOnServer=true prevents DELE; headersOnly=false retrieves complete MIME messages.
success := mailman.FetchAll(1,0,0,bundle.ControlInterface);
if (success <> 1) then
  begin
    mailman.Pop3EndSessionNoQuit();
    Memo1.Lines.Add('Could not download the messages.');
    Exit;
  end;
//  Check completeness as well as the method result. Another client can change the mailbox.
if (bundle.MessageCount < count) then
  begin
    mailman.Pop3EndSessionNoQuit();
    Memo1.Lines.Add('Downloaded fewer messages than the initial count. Check for retrieval errors or mailbox changes.');
    Exit;
  end;
email := TChilkatEmail.Create(Self);
i := 0;
while (i < bundle.MessageCount) do
  begin
    success := bundle.EmailAt(i,email.ControlInterface);
    if (success <> 1) then
      begin
        mailman.Pop3EndSessionNoQuit();
        Memo1.Lines.Add('Could not read a downloaded message.');
        Exit;
      end;
    Memo1.Lines.Add('Subject: ' + email.Subject);
    i := i + 1;
  end;

success := mailman.Pop3EndSession();
if (success <> 1) then
  begin
    Memo1.Lines.Add('Messages were downloaded, but closing the POP session failed.');
    Exit;
  end;
Memo1.Lines.Add('Messages downloaded without deletion: ' + IntToStr(bundle.MessageCount));