{"title":"Codeunit 5321 Exchange Web Services Server, procedures","url":"https://jonas-paprotka.de/ref/codeunit/5321-exchange-web-services-server/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":5321,"name":"Exchange Web Services Server","app":"Base Application","versions":"17-29","url":"https://jonas-paprotka.de/ref/codeunit/5321-exchange-web-services-server/","json":"https://jonas-paprotka.de/ref/codeunit/5321-exchange-web-services-server.json"},"aspect":"procedures","total":25,"rows":[{"name":"Initialize","sig":"(Text[250], Text, DotNet ExchangeCredentials, Boolean)","named":"(AutodiscoveryEmail: Text[250]; ServiceUri: Text; Credentials: DotNet ExchangeCredentials; Rediscover: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(AutodiscoveryEmail: Text[250]; ServiceUri: Text; Credentials: DotNet ExchangeCredentials; Rediscover: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"InitializeAndValidate","sig":"(Text[250], var Text, DotNet ExchangeCredentials)","named":"(AutodiscoveryEmail: Text[250]; var ServiceUri: Text; Credentials: DotNet ExchangeCredentials)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(AutodiscoveryEmail: Text[250]; var ServiceUri: Text; Credentials: DotNet ExchangeCredentials)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"Initialize2010","sig":"(Text[250], Text, DotNet ExchangeCredentials, Boolean)","named":"(AutodiscoveryEmail: Text[250]; ServiceUri: Text; Credentials: DotNet ExchangeCredentials; Rediscover: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(AutodiscoveryEmail: Text[250]; ServiceUri: Text; Credentials: DotNet ExchangeCredentials; Rediscover: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"Initialize2010WithUserImpersonation","sig":"(Text[250], Text, DotNet ExchangeCredentials, Boolean)","named":"(AutodiscoveryEmail: Text[250]; ServiceUri: Text; Credentials: DotNet ExchangeCredentials; Rediscover: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(AutodiscoveryEmail: Text[250]; ServiceUri: Text; Credentials: DotNet ExchangeCredentials; Rediscover: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"InitializeWithCertificate","sig":"(Guid, Text[40], Text[250], Text[250], Text[250])","named":"(ApplicationID: Guid; Thumbprint: Text[40]; AuthenticationEndpoint: Text[250]; ExchangeEndpoint: Text[250]; ResourceUri: Text[250])","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(ApplicationID: Guid; Thumbprint: Text[40]; AuthenticationEndpoint: Text[250]; ExchangeEndpoint: Text[250]; ResourceUri: Text[250])","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"InitializeWithOAuthToken","sig":"(Text, Text)","named":"(Token: Text; ExchangeEndpoint: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replaced by InitializeWithOAuthToken(Token: SecretText; ExchangeEndpoint: Text)","tag":"25.0"},"range":"17-27","first":17,"last":27,"obsoleteSince":25,"spans":[{"from":17,"to":24,"named":"(Token: Text; ExchangeEndpoint: Text)","returns":"","kind":"procedure","access":"public","obsolete":null},{"from":25,"to":27,"named":"(Token: Text; ExchangeEndpoint: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replaced by InitializeWithOAuthToken(Token: SecretText; ExchangeEndpoint: Text)","tag":"25.0"}}]},{"name":"ValidCredentials","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":"SetImpersonatedIdentity","sig":"(Text[250])","named":"(Email: Text[250])","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(Email: Text[250])","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"InstallApp","sig":"(InStream)","named":"(ManifestPath: InStream)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(ManifestPath: InStream)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"CreateAppointment","sig":"(var DotNet IAppointment)","named":"(var Appointment: DotNet IAppointment)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var Appointment: DotNet IAppointment)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"SendEmailMessageWithAttachment","sig":"(Text, Text, Text, Text, Text)","named":"(Subject: Text; RecipientAddress: Text; BodyHTML: Text; AttachmentPath: Text; SenderAddress: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(Subject: Text; RecipientAddress: Text; BodyHTML: Text; AttachmentPath: Text; SenderAddress: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"SaveEmailToInbox","sig":"(Text)","named":"(EmailMessage: Text)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(EmailMessage: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"SaveHTMLEmailToInbox","sig":"(Text, Text, Text, Text, Text)","named":"(EmailSubject: Text; EmailBodyHTML: Text; SenderAddress: Text; SenderName: Text; RecipientAddress: Text)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(EmailSubject: Text; EmailBodyHTML: Text; SenderAddress: Text; SenderName: Text; RecipientAddress: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetEmailFolder","sig":"(Text, var DotNet IEmailFolder)","named":"(FolderId: Text; var Folder: DotNet IEmailFolder)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(FolderId: Text; var Folder: DotNet IEmailFolder)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"IdenticalMailExists","sig":"(DotNet IEmailMessage, DotNet IEmailFolder, var DotNet IEmailMessage)","named":"(SampleMessage: DotNet IEmailMessage; TargetFolder: DotNet IEmailFolder; var TargetMessage: DotNet IEmailMessage)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(SampleMessage: DotNet IEmailMessage; TargetFolder: DotNet IEmailFolder; var TargetMessage: DotNet IEmailMessage)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"CompareEmailAttachments","sig":"(DotNet IEmailMessage, DotNet IEmailMessage)","named":"(LeftMsg: DotNet IEmailMessage; RightMsg: DotNet IEmailMessage)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(LeftMsg: DotNet IEmailMessage; RightMsg: DotNet IEmailMessage)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetEmailAndAttachments","sig":"(Text[250], var Record Exchange Object, Option, Code[20])","named":"(ItemID: Text[250]; var TempExchangeObject: Record \"Exchange Object\" temporary; Action: Option InitiateSendToOCR,InitiateSendToIncomingDocuments,InitiateSendToWorkFlow,IntiateSendToAttachments; VendorNumber: Code[20])","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Please use GetEmailAndAttachments which uses RecordRef instead of Vendor number.","tag":"20.0"},"range":"17-22","first":17,"last":22,"obsoleteSince":20,"spans":[{"from":17,"to":19,"named":"(ItemID: Text[250]; var TempExchangeObject: Record \"Exchange Object\" temporary; Action: Option InitiateSendToOCR,InitiateSendToIncomingDocuments,InitiateSendToWorkFlow; VendorNumber: Code[20])","returns":"","kind":"procedure","access":"public","obsolete":null},{"from":20,"to":22,"named":"(ItemID: Text[250]; var TempExchangeObject: Record \"Exchange Object\" temporary; Action: Option InitiateSendToOCR,InitiateSendToIncomingDocuments,InitiateSendToWorkFlow,IntiateSendToAttachments; VendorNumber: Code[20])","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Please use GetEmailAndAttachments which uses RecordRef instead of Vendor number.","tag":"20.0"}}]},{"name":"GetEmailBody","sig":"(Text[250])","named":"(ItemID: Text[250])","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Please use Microsoft Graph API instead e.g `Email - Outlook REST API`","tag":"28.0"},"range":"17-29","first":17,"last":29,"obsoleteSince":28,"spans":[{"from":17,"to":27,"named":"(ItemID: Text[250])","returns":"Text","kind":"procedure","access":"public","obsolete":null},{"from":28,"to":29,"named":"(ItemID: Text[250])","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Please use Microsoft Graph API instead e.g `Email - Outlook REST API`","tag":"28.0"}}]},{"name":"EmailHasAttachments","sig":"(Text[250])","named":"(ItemID: Text[250])","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Please use Microsoft Graph API instead e.g `Email - Outlook REST API`","tag":"28.0"},"range":"17-29","first":17,"last":29,"obsoleteSince":28,"spans":[{"from":17,"to":27,"named":"(ItemID: Text[250])","returns":"Boolean","kind":"procedure","access":"public","obsolete":null},{"from":28,"to":29,"named":"(ItemID: Text[250])","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Please use Microsoft Graph API instead e.g `Email - Outlook REST API`","tag":"28.0"}}]},{"name":"GetEndpoint","sig":"()","named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"ProdEndpoint","sig":"()","named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetCurrentUserTimeZone","sig":"()","named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetEmailAndAttachments","sig":"(Text[250], var Record Exchange Object, Option, RecordRef)","named":"(ItemID: Text[250]; var TempExchangeObject: Record \"Exchange Object\" temporary; Action: Option InitiateSendToOCR,InitiateSendToIncomingDocuments,InitiateSendToWorkFlow,IntiateSendToAttachments; RecRef: RecordRef)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Please use Microsoft Graph API instead e.g `Email - Outlook REST API`","tag":"28.0"},"range":"20-29","first":20,"last":29,"obsoleteSince":28,"spans":[{"from":20,"to":27,"named":"(ItemID: Text[250]; var TempExchangeObject: Record \"Exchange Object\" temporary; Action: Option InitiateSendToOCR,InitiateSendToIncomingDocuments,InitiateSendToWorkFlow,IntiateSendToAttachments; RecRef: RecordRef)","returns":"","kind":"procedure","access":"public","obsolete":null},{"from":28,"to":29,"named":"(ItemID: Text[250]; var TempExchangeObject: Record \"Exchange Object\" temporary; Action: Option InitiateSendToOCR,InitiateSendToIncomingDocuments,InitiateSendToWorkFlow,IntiateSendToAttachments; RecRef: RecordRef)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Please use Microsoft Graph API instead e.g `Email - Outlook REST API`","tag":"28.0"}}]},{"name":"IsDefaultProdEndpoint","sig":"(Text)","named":"(Endpoint: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"21-29","first":21,"last":29,"obsoleteSince":null,"spans":[{"from":21,"to":29,"named":"(Endpoint: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"InitializeWithOAuthToken","sig":"(SecretText, Text)","named":"(Token: SecretText; ExchangeEndpoint: Text)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"25-29","first":25,"last":29,"obsoleteSince":null,"spans":[{"from":25,"to":29,"named":"(Token: SecretText; ExchangeEndpoint: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}]}]}