{"title":"Codeunit 9520 Mail Management, events","url":"https://jonas-paprotka.de/ref/codeunit/9520-mail-management/events/","author":"JOP-AL","license":"Metadata from Microsoft's symbol packages. AL source MIT, Copyright (c) Microsoft Corporation. Selection and wording © 2026 JOP-AL. https://jonas-paprotka.de/licenses/","subject":"Microsoft Dynamics 365 Business Central","checked":"2026-11-20","changed":"2026-10-05","object":{"type":"codeunit","id":9520,"name":"Mail Management","app":"Base Application","versions":"17-29","url":"https://jonas-paprotka.de/ref/codeunit/9520-mail-management/","json":"https://jonas-paprotka.de/ref/codeunit/9520-mail-management.json"},"aspect":"events","total":32,"rows":[{"name":"OnAfterSentViaSMTP","sig":"(var Record Email Item, var Codeunit SMTP Mail, var Boolean, Boolean)","named":"(var TempEmailItem: Record \"Email Item\" temporary; var SMTPMail: Codeunit \"SMTP Mail\"; var MailSent: Boolean; HideSMTPError: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"SMTP Mail codeunit has been obsolete","tag":"19.3"},"range":"17-19","first":17,"last":19,"obsoleteSince":19,"spans":[{"from":17,"to":18,"named":"(var TempEmailItem: Record \"Email Item\" temporary; var SMTPMail: Codeunit \"SMTP Mail\"; var MailSent: Boolean; HideSMTPError: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null},{"from":19,"to":19,"named":"(var TempEmailItem: Record \"Email Item\" temporary; var SMTPMail: Codeunit \"SMTP Mail\"; var MailSent: Boolean; HideSMTPError: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"SMTP Mail codeunit has been obsolete","tag":"19.3"}}]},{"name":"OnBeforeCheckValidEmailAddress","sig":"(Text, var Boolean)","named":"(Recipients: Text; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"Replaced by event OnBeforeCheckValidEmailAddresses","tag":"15.3"},"range":"17","first":17,"last":17,"obsoleteSince":17,"spans":[{"from":17,"to":17,"named":"(Recipients: Text; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"Replaced by event OnBeforeCheckValidEmailAddresses","tag":"15.3"}}]},{"name":"OnBeforeCheckValidEmailAddresses","sig":"(Text, var Boolean)","named":"(Recipients: Text; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(Recipients: Text; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnBeforeCheckValidEmailAddr","sig":"(Text, var Boolean)","named":"(EmailAddress: Text; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(EmailAddress: Text; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnBeforeDoSending","sig":"(var Boolean)","named":"(var CancelSending: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var CancelSending: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnBeforeDownloadPdfAttachment","sig":"(var Record Email Item, var Boolean)","named":"(var TempEmailItem: Record \"Email Item\" temporary; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var TempEmailItem: Record \"Email Item\" temporary; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnBeforeQualifyFromAddress","sig":"(var Record Email Item)","named":"(var TempEmailItem: Record \"Email Item\" temporary)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var TempEmailItem: Record \"Email Item\" temporary)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnBeforeRunMailDialog","sig":"(var Record Email Item, Boolean, Boolean, var Boolean, var Boolean, var Boolean, var Boolean)","named":"(var TempEmailItem: Record \"Email Item\"; OutlookSupported: Boolean; SMTPSupported: Boolean; var ReturnValue: Boolean; var IsHandled: Boolean; var DoEdit: Boolean; var Cancelled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"Email dialog has been removed, event no longer relevant.","tag":"20.0"},"range":"17-22","first":17,"last":22,"obsoleteSince":20,"spans":[{"from":17,"to":19,"named":"(var TempEmailItem: Record \"Email Item\"; OutlookSupported: Boolean; SMTPSupported: Boolean; var ReturnValue: Boolean; var IsHandled: Boolean; var DoEdit: Boolean; var Cancelled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null},{"from":20,"to":22,"named":"(var TempEmailItem: Record \"Email Item\"; OutlookSupported: Boolean; SMTPSupported: Boolean; var ReturnValue: Boolean; var IsHandled: Boolean; var DoEdit: Boolean; var Cancelled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"Email dialog has been removed, event no longer relevant.","tag":"20.0"}}]},{"name":"OnBeforeSentViaSMTP","sig":"(var Record Email Item, var Codeunit SMTP Mail)","named":"(var TempEmailItem: Record \"Email Item\" temporary; var SMTPMail: Codeunit \"SMTP Mail\")","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"SMTP Mail codeunit has been obsolete","tag":"19.3"},"range":"17-19","first":17,"last":19,"obsoleteSince":19,"spans":[{"from":17,"to":18,"named":"(var TempEmailItem: Record \"Email Item\" temporary; var SMTPMail: Codeunit \"SMTP Mail\")","returns":"","kind":"integrationevent","access":"local","obsolete":null},{"from":19,"to":19,"named":"(var TempEmailItem: Record \"Email Item\" temporary; var SMTPMail: Codeunit \"SMTP Mail\")","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"SMTP Mail codeunit has been obsolete","tag":"19.3"}}]},{"name":"OnBeforeValidateEmailAddressField","sig":"(var Text, var Boolean)","named":"(var EmailAddress: Text; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var EmailAddress: Text; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnBeforeSendMailOnWinClient","sig":"(var Record Email Item)","named":"(var TempEmailItem: Record \"Email Item\" temporary)","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"This event is never raised.","tag":"27.0"},"range":"17-29","first":17,"last":29,"obsoleteSince":27,"spans":[{"from":17,"to":26,"named":"(var TempEmailItem: Record \"Email Item\" temporary)","returns":"","kind":"integrationevent","access":"local","obsolete":null},{"from":27,"to":29,"named":"(var TempEmailItem: Record \"Email Item\" temporary)","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"This event is never raised.","tag":"27.0"}}]},{"name":"OnAfterDeleteTempAttachments","sig":"(var Record Email Item)","named":"(var EmailItem: Record \"Email Item\")","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"This event is never raised.","tag":"27.0"},"range":"17-29","first":17,"last":29,"obsoleteSince":27,"spans":[{"from":17,"to":26,"named":"(var EmailItem: Record \"Email Item\")","returns":"","kind":"integrationevent","access":"local","obsolete":null},{"from":27,"to":29,"named":"(var EmailItem: Record \"Email Item\")","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"This event is never raised.","tag":"27.0"}}]},{"name":"OnAfterGetSenderEmailAddress","sig":"(var Record Email Item)","named":"(var EmailItem: Record \"Email Item\")","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var EmailItem: Record \"Email Item\")","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnAfterSendMailOrDownload","sig":"(var Record Email Item, var Boolean)","named":"(var TempEmailItem: Record \"Email Item\" temporary; var MailSent: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var TempEmailItem: Record \"Email Item\" temporary; var MailSent: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnBeforeImageBase64ToUrl","sig":"(var Text, var Text, var DotNet Regex, var DotNet MemoryStream, var Guid, var Text, var DotNet Convert, var Boolean)","named":"(var BodyText: Text; var SearchText: Text; var Regex: DotNet Regex; var MemoryStream: DotNet MemoryStream; var MediaId: Guid; var Base64: Text; var Convert: DotNet Convert; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var BodyText: Text; var SearchText: Text; var Regex: DotNet Regex; var MemoryStream: DotNet MemoryStream; var MediaId: Guid; var Base64: Text; var Convert: DotNet Convert; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnSendOnBeforeQualifyFromAddress","sig":"(var Record Email Item, Enum Email Scenario)","named":"(var TempEmailItem: Record \"Email Item\" temporary; EmailScenario: Enum \"Email Scenario\")","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var TempEmailItem: Record \"Email Item\" temporary; EmailScenario: Enum \"Email Scenario\")","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnSendMailOrDownloadOnBeforeMailManagementIsSent","sig":"(var Codeunit Mail Management)","named":"(var MailManagement: Codeunit \"Mail Management\")","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"17","first":17,"last":17,"obsoleteSince":null,"spans":[{"from":17,"to":17,"named":"(var MailManagement: Codeunit \"Mail Management\")","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnSendViaEmailModuleOnAfterAddAttachments","sig":"(var Codeunit Email Message, var Record Email Item)","named":"(var Message: Codeunit \"Email Message\"; var TempEmailItem: Record \"Email Item\" temporary)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var Message: Codeunit \"Email Message\"; var TempEmailItem: Record \"Email Item\" temporary)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnSendViaEmailModuleOnAfterCreateMessage","sig":"(var Codeunit Email Message, var Record Email Item)","named":"(var Message: Codeunit \"Email Message\"; var TempEmailItem: Record \"Email Item\" temporary)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var Message: Codeunit \"Email Message\"; var TempEmailItem: Record \"Email Item\" temporary)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnSendViaSMTPOnBeforeSMTPMailAddAttachment","sig":"(var Record Email Item, var Codeunit SMTP Mail)","named":"(var TempEmailItem: Record \"Email Item\" temporary; var SMTPMail: Codeunit \"SMTP Mail\")","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"SMTP Mail codeunit has been obsolete","tag":"19.3"},"range":"17-19","first":17,"last":19,"obsoleteSince":19,"spans":[{"from":17,"to":18,"named":"(var TempEmailItem: Record \"Email Item\" temporary; var SMTPMail: Codeunit \"SMTP Mail\")","returns":"","kind":"integrationevent","access":"local","obsolete":null},{"from":19,"to":19,"named":"(var TempEmailItem: Record \"Email Item\" temporary; var SMTPMail: Codeunit \"SMTP Mail\")","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"SMTP Mail codeunit has been obsolete","tag":"19.3"}}]},{"name":"OnBeforeIsEnabled","sig":"(Boolean, var Boolean, var Boolean)","named":"(OutlookSupported: Boolean; var Result: Boolean; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"18-29","first":18,"last":29,"obsoleteSince":null,"spans":[{"from":18,"to":29,"named":"(OutlookSupported: Boolean; var Result: Boolean; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnQualifyFromAddressOnAfterGetEmailAccount","sig":"(var Record Email Item, Enum Email Scenario, var Record Email Account)","named":"(var TempEmailItem: Record \"Email Item\" temporary; EmailScenario: Enum \"Email Scenario\"; var TempEmailAccount: Record \"Email Account\" temporary)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"18-29","first":18,"last":29,"obsoleteSince":null,"spans":[{"from":18,"to":29,"named":"(var TempEmailItem: Record \"Email Item\" temporary; EmailScenario: Enum \"Email Scenario\"; var TempEmailAccount: Record \"Email Account\" temporary)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnSendMailOrDownloadOnBeforeMailManagementIsSent","sig":"(var Codeunit Mail Management, Record Email Item)","named":"(var MailManagement: Codeunit \"Mail Management\"; TempEmailItem: Record \"Email Item\" temporary)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"18-29","first":18,"last":29,"obsoleteSince":null,"spans":[{"from":18,"to":29,"named":"(var MailManagement: Codeunit \"Mail Management\"; TempEmailItem: Record \"Email Item\" temporary)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnSendViaEmailModuleOnAfterEmailSend","sig":"(var Codeunit Email Message, var Record Email Item, var Boolean, var Boolean, var Boolean)","named":"(var Message: Codeunit \"Email Message\"; var TempEmailItem: Record \"Email Item\" temporary; var MailSent: Boolean; var Cancelled: Boolean; var HideEmailSendingError: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"18-29","first":18,"last":29,"obsoleteSince":null,"spans":[{"from":18,"to":29,"named":"(var Message: Codeunit \"Email Message\"; var TempEmailItem: Record \"Email Item\" temporary; var MailSent: Boolean; var Cancelled: Boolean; var HideEmailSendingError: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnSetIsHandlingGetEmailBodyCustomer","sig":"(var Boolean)","named":"(var Result: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"19-29","first":19,"last":29,"obsoleteSince":null,"spans":[{"from":19,"to":29,"named":"(var Result: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnSetIsHandlingGetEmailBodyVendor","sig":"(var Boolean)","named":"(var Result: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"19-29","first":19,"last":29,"obsoleteSince":null,"spans":[{"from":19,"to":29,"named":"(var Result: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnAfterIsBackground","sig":"(var Boolean)","named":"(var Result: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"21-29","first":21,"last":29,"obsoleteSince":null,"spans":[{"from":21,"to":29,"named":"(var Result: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnAfterGetAttachmentName","sig":"(List, Integer, var Text[250])","named":"(AttachmentNames: List of [Text]; Index: Integer; var AttachmentName: Text[250])","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"21-22","first":21,"last":22,"obsoleteSince":null,"spans":[{"from":21,"to":22,"named":"(AttachmentNames: List of [Text]; Index: Integer; var AttachmentName: Text[250])","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnAfterGetAttachmentName","sig":"(List, Integer, var Text[250], var Record Email Item)","named":"(AttachmentNames: List of [Text]; Index: Integer; var AttachmentName: Text[250]; var TempEmailItem: Record \"Email Item\" temporary)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"23-29","first":23,"last":29,"obsoleteSince":null,"spans":[{"from":23,"to":29,"named":"(AttachmentNames: List of [Text]; Index: Integer; var AttachmentName: Text[250]; var TempEmailItem: Record \"Email Item\" temporary)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnBeforeSendViaEmailModule","sig":"(var Record Email Item, Enum Email Scenario, var Record Email Account, Boolean, var Boolean, var Boolean)","named":"(var TempEmailItem: Record \"Email Item\" temporary; EmailScenario: Enum \"Email Scenario\"; var TempEmailAccount: Record \"Email Account\" temporary; HideMailDialog: Boolean; var IsHandled: Boolean; var Result: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"23-29","first":23,"last":29,"obsoleteSince":null,"spans":[{"from":23,"to":29,"named":"(var TempEmailItem: Record \"Email Item\" temporary; EmailScenario: Enum \"Email Scenario\"; var TempEmailAccount: Record \"Email Account\" temporary; HideMailDialog: Boolean; var IsHandled: Boolean; var Result: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnAfterDownloadPDFAttachment","sig":"()","named":"()","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"23-29","first":23,"last":29,"obsoleteSince":null,"spans":[{"from":23,"to":29,"named":"()","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnSendViaEmailModuleOnBeforeOpenInEditorModally","sig":"(Enum Email Scenario, var Record Email Account, var Codeunit Email Message, var Boolean)","named":"(EmailScenario: Enum \"Email Scenario\"; var TempEmailAccount: Record \"Email Account\" temporary; var Message: Codeunit \"Email Message\"; var HideMailDialog: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"named":"(EmailScenario: Enum \"Email Scenario\"; var TempEmailAccount: Record \"Email Account\" temporary; var Message: Codeunit \"Email Message\"; var HideMailDialog: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]}]}