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
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));