Exchange

Frends.Exchange.ReadEmail / 2.0.0

Summary

Reads a mailbox through Microsoft Graph, optionally saving attachments to disk, and narrows what it fetches server-side by sender, filter and ordering rather than pulling everything down first.

Typical use — mail-triggered integrations, where filtering at the server is what keeps a busy mailbox from dominating the run

Details

Frends version
5.7 and newer
Agent
Crossplatform
Target framework
net8.0
2.0.02026-09-04
Changed
  • Upgraded the Task to target .NET 8.
  • Removed MimeKit library.
  • Breaking: Renamed Options.ThrowExceptionOnFailure to Options.ThrowErrorOnFailure.
  • Breaking: Replaced Result.ErrorMessages with a single Result.Error object containing the error Message and AdditionalInfo.
Added
  • Added Options.ErrorMessageOnFailure to allow overriding the error message shown when the Task fails.
1.5.02026-05-07
Added
  • Added Mailbox parameter to Connection to allow reading emails from a mailbox different than the authenticated user. For UsernamePassword authentication, if Mailbox is empty, the authenticated user's mailbox is used. For ClientCredentials authentication, if Mailbox is empty, Input.From is used as fallback.
1.4.02026-03-20
Added
  • Added DeleteReadEmails option to permanently delete emails after they are read and processed.
1.3.02025-10-17
Changed
  • Changed ClientSecret to a password property.
1.2.02024-08-22
Changed
  • Updated the Azure.Identity, Newtonsoft.Json and Mimekit libraries to their latest versions.
1.1.02023-05-24
Fixed
  • Skip parameter is null instead of zero when it is not supported
1.0.02023-05-12
Added
  • Initial implementation
An unhandled error has occurred. Reload 🗙