{"title":"Codeunit 400 SMTP Mail, procedures","url":"https://jonas-paprotka.de/ref/codeunit/400-smtp-mail/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-09-24","object":{"type":"codeunit","id":400,"name":"SMTP Mail","app":"Base Application","versions":"17-19","url":"https://jonas-paprotka.de/ref/codeunit/400-smtp-mail/","json":"https://jonas-paprotka.de/ref/codeunit/400-smtp-mail.json"},"aspect":"procedures","total":56,"rows":[{"name":"Initialize","sig":"()","named":"()","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"()","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"AddFrom","sig":"(Text, Text)","named":"(FromName: Text; FromAddress: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(FromName: Text; FromAddress: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"AddRecipients","sig":"(List)","named":"(Recipients: List of [Text])","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(Recipients: List of [Text])","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"AddCC","sig":"(List)","named":"(Recipients: List of [Text])","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(Recipients: List of [Text])","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"AddBCC","sig":"(List)","named":"(Recipients: List of [Text])","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(Recipients: List of [Text])","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"AddSubject","sig":"(Text)","named":"(Subject: Text)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(Subject: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"AddBody","sig":"(Text)","named":"(Body: Text)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(Body: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"AddTextBody","sig":"(Text)","named":"(Body: Text)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(Body: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"AppendBody","sig":"(Text)","named":"(BodyPart: Text)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(BodyPart: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"AppendTextBody","sig":"(Text)","named":"(BodyPart: Text)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(BodyPart: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetFrom","sig":"()","named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetRecipients","sig":"(var List)","named":"(var Recipients: List of [Text])","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(var Recipients: List of [Text])","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetCC","sig":"(var List)","named":"(var Recipients: List of [Text])","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(var Recipients: List of [Text])","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetBCC","sig":"(var List)","named":"(var Recipients: List of [Text])","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(var Recipients: List of [Text])","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetSubject","sig":"()","named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetBody","sig":"()","named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetLinkedResourcesCount","sig":"()","named":"()","returns":"Integer","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"()","returns":"Integer","kind":"procedure","access":"public","obsolete":null}]},{"name":"IsBodyHtmlFormatted","sig":"()","named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"CreateMessage","sig":"(Text, Text, Text, Text, Text, Boolean)","named":"(FromName: Text; FromAddress: Text; Recipient: Text; Subject: Text; Body: Text; HtmlFormatted: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"This method is obsolete. A new CreateMessage overload is available, with the following parameters (FromName: Text; FromAddress: Text; Recipients: List of [Text]; Subject: Text; Body: Text).","tag":"15.0"},"range":"17","first":17,"last":17,"obsoleteSince":17,"spans":[{"from":17,"to":17,"named":"(FromName: Text; FromAddress: Text; Recipient: Text; Subject: Text; Body: Text; HtmlFormatted: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"This method is obsolete. A new CreateMessage overload is available, with the following parameters (FromName: Text; FromAddress: Text; Recipients: List of [Text]; Subject: Text; Body: Text).","tag":"15.0"}}]},{"name":"CreateMessage","sig":"(Text, Text, List, Text, Text)","named":"(FromName: Text; FromAddress: Text; Recipients: List of [Text]; Subject: Text; Body: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(FromName: Text; FromAddress: Text; Recipients: List of [Text]; Subject: Text; Body: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"CreateMessage","sig":"(Text, Text, List, Text, Text, Boolean)","named":"(FromName: Text; FromAddress: Text; Recipients: List of [Text]; Subject: Text; Body: Text; HtmlFormatted: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(FromName: Text; FromAddress: Text; Recipients: List of [Text]; Subject: Text; Body: Text; HtmlFormatted: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"Send","sig":"()","named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"SendShowError","sig":"()","named":"()","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"()","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"AddAttachment","sig":"(Text, Text)","named":"(AttachmentPath: Text; FileName: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(AttachmentPath: Text; FileName: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"AddAttachmentStream","sig":"(InStream, Text)","named":"(AttachmentStream: InStream; AttachmentName: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(AttachmentStream: InStream; AttachmentName: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"IsEnabled","sig":"()","named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"CheckValidEmailAddresses","sig":"(Text)","named":"(Recipients: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Please call CheckValidEmailAddresses from the Mail Management codeunit directly.","tag":"16.0"},"range":"17-18","first":17,"last":18,"obsoleteSince":17,"spans":[{"from":17,"to":18,"named":"(Recipients: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Please call CheckValidEmailAddresses from the Mail Management codeunit directly.","tag":"16.0"}}]},{"name":"GetLastSendMailErrorText","sig":"()","named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetSmtpErrorCodeFromResponse","sig":"(Text)","named":"(ErrorResponse: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(ErrorResponse: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetFriendlyMessageFromSmtpErrorCode","sig":"(Text)","named":"(ErrorCode: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(ErrorCode: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"HandleSMTPRegisterServiceConnection","sig":"(var Record Service Connection)","named":"(var ServiceConnection: Record \"Service Connection\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(var ServiceConnection: Record \"Service Connection\")","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"ShowNotificationDetail","sig":"(Notification)","named":"(Notification: Notification)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(Notification: Notification)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetO365SmtpServer","sig":"()","named":"()","returns":"Text[250]","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"()","returns":"Text[250]","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetOutlookSmtpServer","sig":"()","named":"()","returns":"Text[250]","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"()","returns":"Text[250]","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetGmailSmtpServer","sig":"()","named":"()","returns":"Text[250]","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"()","returns":"Text[250]","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetYahooSmtpServer","sig":"()","named":"()","returns":"Text[250]","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"()","returns":"Text[250]","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetDefaultSmtpPort","sig":"()","named":"()","returns":"Integer","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"()","returns":"Integer","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetYahooSmtpPort","sig":"()","named":"()","returns":"Integer","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"()","returns":"Integer","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetDefaultSmtpAuthType","sig":"()","named":"()","returns":"Integer","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"()","returns":"Integer","kind":"procedure","access":"public","obsolete":null}]},{"name":"OpenNotificationHyperlink","sig":"(Notification)","named":"(Notification: Notification)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(Notification: Notification)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"AddTroubleshootingLinksToNotification","sig":"(var Notification)","named":"(var TargetNotification: Notification)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(var TargetNotification: Notification)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"ApplyOffice365Smtp","sig":"(var Record SMTP Mail Setup)","named":"(var SMTPMailSetupConfig: Record \"SMTP Mail Setup\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(var SMTPMailSetupConfig: Record \"SMTP Mail Setup\")","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"ApplyOutlookSmtp","sig":"(var Record SMTP Mail Setup)","named":"(var SMTPMailSetupConfig: Record \"SMTP Mail Setup\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(var SMTPMailSetupConfig: Record \"SMTP Mail Setup\")","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"ApplyGmailSmtp","sig":"(var Record SMTP Mail Setup)","named":"(var SMTPMailSetupConfig: Record \"SMTP Mail Setup\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(var SMTPMailSetupConfig: Record \"SMTP Mail Setup\")","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"ApplyYahooSmtp","sig":"(var Record SMTP Mail Setup)","named":"(var SMTPMailSetupConfig: Record \"SMTP Mail Setup\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(var SMTPMailSetupConfig: Record \"SMTP Mail Setup\")","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"IsOffice365Setup","sig":"(var Record SMTP Mail Setup)","named":"(var SMTPMailSetupConfig: Record \"SMTP Mail Setup\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(var SMTPMailSetupConfig: Record \"SMTP Mail Setup\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"IsOutlookSetup","sig":"(var Record SMTP Mail Setup)","named":"(var SMTPMailSetupConfig: Record \"SMTP Mail Setup\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(var SMTPMailSetupConfig: Record \"SMTP Mail Setup\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"IsGmailSetup","sig":"(var Record SMTP Mail Setup)","named":"(var SMTPMailSetupConfig: Record \"SMTP Mail Setup\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(var SMTPMailSetupConfig: Record \"SMTP Mail Setup\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"IsYahooSetup","sig":"(var Record SMTP Mail Setup)","named":"(var SMTPMailSetupConfig: Record \"SMTP Mail Setup\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(var SMTPMailSetupConfig: Record \"SMTP Mail Setup\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"IsSmtpAuthErrorCode","sig":"(Text)","named":"(ErrorCode: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(ErrorCode: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"IsSmtpRecipientErrorCode","sig":"(Text)","named":"(ErrorCode: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(ErrorCode: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"IsSmtpSendAsErrorCode","sig":"(Text)","named":"(ErrorCode: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-19","first":17,"last":19,"obsoleteSince":null,"spans":[{"from":17,"to":19,"named":"(ErrorCode: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetOAuth2Credentials","sig":"(var Text, var Text)","named":"(var UserName: Text; var AuthToken: Text)","returns":"","kind":"procedure","access":"internal","obsolete":null,"range":"18-19","first":18,"last":19,"obsoleteSince":null,"spans":[{"from":18,"to":19,"named":"(var UserName: Text; var AuthToken: Text)","returns":"","kind":"procedure","access":"internal","obsolete":null}]},{"name":"AuthenticateWithOAuth2","sig":"()","named":"()","returns":"","kind":"procedure","access":"internal","obsolete":null,"range":"18-19","first":18,"last":19,"obsoleteSince":null,"spans":[{"from":18,"to":19,"named":"()","returns":"","kind":"procedure","access":"internal","obsolete":null}]},{"name":"CheckOAuth2Authentication","sig":"()","named":"()","returns":"","kind":"procedure","access":"internal","obsolete":null,"range":"18-19","first":18,"last":19,"obsoleteSince":null,"spans":[{"from":18,"to":19,"named":"()","returns":"","kind":"procedure","access":"internal","obsolete":null}]},{"name":"GetUserName","sig":"(Text, var Text)","named":"(AccessToken: Text; var UserName: Text)","returns":"Boolean","kind":"procedure","access":"internal","obsolete":null,"range":"18-19","first":18,"last":19,"obsoleteSince":null,"spans":[{"from":18,"to":19,"named":"(AccessToken: Text; var UserName: Text)","returns":"Boolean","kind":"procedure","access":"internal","obsolete":null}]}]}