{"title":"Codeunit 9520 Mail Management, procedures","url":"https://jonas-paprotka.de/ref/codeunit/9520-mail-management/procedures/","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":"procedures","total":31,"rows":[{"name":"RecipientStringToList","sig":"(Text, var List)","named":"(DelimitedRecipients: Text; var Recipients: List of [Text])","returns":"","kind":"procedure","access":"internal","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(DelimitedRecipients: Text; var Recipients: List of [Text])","returns":"","kind":"procedure","access":"internal","obsolete":null}]},{"name":"GetLastGraphError","sig":"()","named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Microsoft Invoicing has been discontinued.","tag":"21.0"},"range":"17-23","first":17,"last":23,"obsoleteSince":21,"spans":[{"from":17,"to":20,"named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":null},{"from":21,"to":23,"named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Microsoft Invoicing has been discontinued.","tag":"21.0"}}]},{"name":"InitializeFrom","sig":"(Boolean, Boolean)","named":"(NewHideMailDialog: Boolean; NewHideEmailSendingError: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(NewHideMailDialog: Boolean; NewHideEmailSendingError: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"SetHideMailDialog","sig":"(Boolean)","named":"(NewHideMailDialog: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(NewHideMailDialog: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"SetHideSMTPError","sig":"(Boolean)","named":"(NewHideSMTPError: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replaced with the SetHideEmailSendingError function","tag":"17.0"},"range":"17-19","first":17,"last":19,"obsoleteSince":17,"spans":[{"from":17,"to":19,"named":"(NewHideSMTPError: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replaced with the SetHideEmailSendingError function","tag":"17.0"}}]},{"name":"SetHideEmailSendingError","sig":"(Boolean)","named":"(NewHideEmailSendingError: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(NewHideEmailSendingError: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"CheckValidEmailAddresses","sig":"(Text)","named":"(Recipients: Text)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(Recipients: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"CheckValidEmailAddress","sig":"(Text)","named":"(EmailAddress: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(EmailAddress: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"ValidateEmailAddressField","sig":"(var Text)","named":"(var EmailAddress: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var EmailAddress: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"IsSMTPEnabled","sig":"()","named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replaced with the IsAnyAccountRegistered in \"Email Account\" codeunit from \"System Application\".","tag":"17.0"},"range":"17-19","first":17,"last":19,"obsoleteSince":17,"spans":[{"from":17,"to":19,"named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replaced with the IsAnyAccountRegistered in \"Email Account\" codeunit from \"System Application\".","tag":"17.0"}}]},{"name":"IsGraphEnabled","sig":"()","named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Microsoft Invoicing has been discontinued.","tag":"21.0"},"range":"17-23","first":17,"last":23,"obsoleteSince":21,"spans":[{"from":17,"to":20,"named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":null},{"from":21,"to":23,"named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Microsoft Invoicing has been discontinued.","tag":"21.0"}}]},{"name":"IsEnabled","sig":"()","named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"IsCancelled","sig":"()","named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"IsSent","sig":"()","named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"Send","sig":"(var Record Email Item, Enum Email Scenario)","named":"(var ParmEmailItem: Record \"Email Item\"; EmailScenario: Enum \"Email Scenario\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var ParmEmailItem: Record \"Email Item\"; EmailScenario: Enum \"Email Scenario\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"Send","sig":"(Record Email Item)","named":"(ParmEmailItem: Record \"Email Item\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replaced with the overload containing Email Scenario","tag":"17.0"},"range":"17-23","first":17,"last":23,"obsoleteSince":17,"spans":[{"from":17,"to":23,"named":"(ParmEmailItem: Record \"Email Item\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replaced with the overload containing Email Scenario","tag":"17.0"}}]},{"name":"SendMailOrDownload","sig":"(var Record Email Item, Boolean, Enum Email Scenario)","named":"(var TempEmailItem: Record \"Email Item\" temporary; HideMailDialog: Boolean; EmailScenario: Enum \"Email Scenario\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var TempEmailItem: Record \"Email Item\" temporary; HideMailDialog: Boolean; EmailScenario: Enum \"Email Scenario\")","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"SendMailOrDownload","sig":"(Record Email Item, Boolean)","named":"(TempEmailItem: Record \"Email Item\" temporary; HideMailDialog: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replaced with the overload containing Email Scenario","tag":"17.0"},"range":"17-23","first":17,"last":23,"obsoleteSince":17,"spans":[{"from":17,"to":23,"named":"(TempEmailItem: Record \"Email Item\" temporary; HideMailDialog: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replaced with the overload containing Email Scenario","tag":"17.0"}}]},{"name":"DownloadPdfAttachment","sig":"(var Record Email Item)","named":"(var TempEmailItem: Record \"Email Item\" temporary)","returns":"","kind":"procedure","access":"public","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":"procedure","access":"public","obsolete":null}]},{"name":"ImageBase64ToUrl","sig":"(Text)","named":"(BodyText: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(BodyText: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"TryGetSenderEmailAddress","sig":"(var Text[250])","named":"(var FromAddress: Text[250])","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var FromAddress: Text[250])","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetSenderEmailAddress","sig":"()","named":"()","returns":"Text[250]","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Sender will be chosen based on the scenario parameter to the Send function when using the email feature is enabled. To control which account will be used, use the overload containing Email Scenario.","tag":"17.0"},"range":"17-19","first":17,"last":19,"obsoleteSince":17,"spans":[{"from":17,"to":19,"named":"()","returns":"Text[250]","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Sender will be chosen based on the scenario parameter to the Send function when using the email feature is enabled. To control which account will be used, use the overload containing Email Scenario.","tag":"17.0"}}]},{"name":"GetSenderEmailAddress","sig":"(Enum Email Scenario)","named":"(EmailScenario: Enum \"Email Scenario\")","returns":"Text[250]","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(EmailScenario: Enum \"Email Scenario\")","returns":"Text[250]","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetSMTPCredentials","sig":"(var Record SMTP Mail Setup)","named":"(var SMTPMailSetup: Record \"SMTP Mail Setup\")","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Not needed once email feature is enabled.","tag":"17.0"},"range":"17-19","first":17,"last":19,"obsoleteSince":17,"spans":[{"from":17,"to":19,"named":"(var SMTPMailSetup: Record \"SMTP Mail Setup\")","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Not needed once email feature is enabled.","tag":"17.0"}}]},{"name":"IsHandlingGetEmailBody","sig":"()","named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"IsHandlingGetEmailBodyCustomer","sig":"()","named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"IsHandlingGetEmailBodyVendor","sig":"()","named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"AddSource","sig":"(Integer, Guid)","named":"(TableId: Integer; SystemId: Guid)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"18-29","first":18,"last":29,"obsoleteSince":null,"spans":[{"from":18,"to":29,"named":"(TableId: Integer; SystemId: Guid)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"AddSendTo","sig":"(Text)","named":"(EmailAddresses: Text)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"19-29","first":19,"last":29,"obsoleteSince":null,"spans":[{"from":19,"to":29,"named":"(EmailAddresses: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"Send","sig":"(var Record Email Item, Enum Email Scenario, Boolean)","named":"(var ParmEmailItem: Record \"Email Item\"; EmailScenario: Enum \"Email Scenario\"; Enqueue: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"23-29","first":23,"last":29,"obsoleteSince":null,"spans":[{"from":23,"to":29,"named":"(var ParmEmailItem: Record \"Email Item\"; EmailScenario: Enum \"Email Scenario\"; Enqueue: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"SendMailOrDownload","sig":"(var Record Email Item, Boolean, Enum Email Scenario, Boolean)","named":"(var TempEmailItem: Record \"Email Item\" temporary; HideMailDialog: Boolean; EmailScenario: Enum \"Email Scenario\"; Enqueue: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"23-29","first":23,"last":29,"obsoleteSince":null,"spans":[{"from":23,"to":29,"named":"(var TempEmailItem: Record \"Email Item\" temporary; HideMailDialog: Boolean; EmailScenario: Enum \"Email Scenario\"; Enqueue: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":null}]}]}