{"title":"Codeunit 8901 Email, events","url":"https://jonas-paprotka.de/ref/codeunit/8901-email/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":8901,"name":"Email","app":"System Application","versions":"17-29","url":"https://jonas-paprotka.de/ref/codeunit/8901-email/","json":"https://jonas-paprotka.de/ref/codeunit/8901-email.json"},"aspect":"events","total":18,"rows":[{"name":"OnGetTestEmailBody","sig":"(Enum Email Connector, var Text)","named":"(Connector: Enum \"Email Connector\"; var Body: Text)","returns":"","kind":"integrationevent","access":"public","obsolete":{"state":"Pending","reason":"The event will be removed. Subscribe to OnGetBodyForTestEmail instead","tag":"17.3"},"range":"17-22","first":17,"last":22,"obsoleteSince":17,"spans":[{"from":17,"to":22,"named":"(Connector: Enum \"Email Connector\"; var Body: Text)","returns":"","kind":"integrationevent","access":"public","obsolete":{"state":"Pending","reason":"The event will be removed. Subscribe to OnGetBodyForTestEmail instead","tag":"17.3"}}]},{"name":"OnGetBodyForTestEmail","sig":"(Enum Email Connector, Guid, var Text)","named":"(Connector: Enum \"Email Connector\"; AccountId: Guid; var Body: Text)","returns":"","kind":"integrationevent","access":"internal","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(Connector: Enum \"Email Connector\"; AccountId: Guid; var Body: Text)","returns":"","kind":"integrationevent","access":"internal","obsolete":null}]},{"name":"OnAfterSendEmail","sig":"(Guid, Boolean)","named":"(MessageId: Guid; Status: Boolean)","returns":"","kind":"integrationevent","access":"internal","obsolete":{"state":"Pending","reason":"This event has been replaced with OnAfterEmailSend and OnAfterEmailSendFailed which are isolated.","tag":"20.1"},"range":"17-22","first":17,"last":22,"obsoleteSince":20,"spans":[{"from":17,"to":19,"named":"(MessageId: Guid; Status: Boolean)","returns":"","kind":"integrationevent","access":"internal","obsolete":null},{"from":20,"to":22,"named":"(MessageId: Guid; Status: Boolean)","returns":"","kind":"integrationevent","access":"internal","obsolete":{"state":"Pending","reason":"This event has been replaced with OnAfterEmailSend and OnAfterEmailSendFailed which are isolated.","tag":"20.1"}}]},{"name":"OnShowSource","sig":"(Integer, Guid, var Boolean)","named":"(SourceTableId: Integer; SourceSystemId: Guid; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"internal","obsolete":null,"range":"18-29","first":18,"last":29,"obsoleteSince":null,"spans":[{"from":18,"to":29,"named":"(SourceTableId: Integer; SourceSystemId: Guid; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"internal","obsolete":null}]},{"name":"OnFindRelatedAttachments","sig":"(Integer, Guid, var Record Email Related Attachment)","named":"(SourceTableId: Integer; SourceSystemID: Guid; var EmailRelatedAttachments: Record \"Email Related Attachment\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null,"range":"18-29","first":18,"last":29,"obsoleteSince":null,"spans":[{"from":18,"to":29,"named":"(SourceTableId: Integer; SourceSystemID: Guid; var EmailRelatedAttachments: Record \"Email Related Attachment\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null}]},{"name":"OnGetAttachment","sig":"(Integer, Guid, Guid)","named":"(AttachmentTableID: Integer; AttachmentSystemID: Guid; MessageID: Guid)","returns":"","kind":"integrationevent","access":"internal","obsolete":null,"range":"18-29","first":18,"last":29,"obsoleteSince":null,"spans":[{"from":18,"to":29,"named":"(AttachmentTableID: Integer; AttachmentSystemID: Guid; MessageID: Guid)","returns":"","kind":"integrationevent","access":"internal","obsolete":null}]},{"name":"OnEnqueuedInOutbox","sig":"(Guid)","named":"(MessageId: Guid)","returns":"","kind":"integrationevent","access":"internal","obsolete":null,"range":"18-29","first":18,"last":29,"obsoleteSince":null,"spans":[{"from":18,"to":29,"named":"(MessageId: Guid)","returns":"","kind":"integrationevent","access":"internal","obsolete":null}]},{"name":"OnAfterAddRelation","sig":"(Guid, Integer, Guid, var Dictionary)","named":"(EmailMessageId: Guid; TableId: Integer; SystemId: Guid; var RelatedSystemIds: Dictionary of [Integer, List of [Guid]])","returns":"","kind":"integrationevent","access":"internal","obsolete":null,"range":"19-29","first":19,"last":29,"obsoleteSince":null,"spans":[{"from":19,"to":29,"named":"(EmailMessageId: Guid; TableId: Integer; SystemId: Guid; var RelatedSystemIds: Dictionary of [Integer, List of [Guid]])","returns":"","kind":"integrationevent","access":"internal","obsolete":null}]},{"name":"OnAfterRemoveRelation","sig":"(Guid, Integer, Guid)","named":"(EmailMessageId: Guid; TableId: Integer; SystemId: Guid)","returns":"","kind":"integrationevent","access":"internal","obsolete":null,"range":"19-29","first":19,"last":29,"obsoleteSince":null,"spans":[{"from":19,"to":29,"named":"(EmailMessageId: Guid; TableId: Integer; SystemId: Guid)","returns":"","kind":"integrationevent","access":"internal","obsolete":null}]},{"name":"OnAfterEmailSent","sig":"(Record Sent Email)","named":"(SentEmail: Record \"Sent Email\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null,"range":"20-29","first":20,"last":29,"obsoleteSince":null,"spans":[{"from":20,"to":29,"named":"(SentEmail: Record \"Sent Email\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null}]},{"name":"OnAfterEmailSendFailed","sig":"(Record Email Outbox)","named":"(EmailOutbox: Record \"Email Outbox\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null,"range":"20-29","first":20,"last":29,"obsoleteSince":null,"spans":[{"from":20,"to":29,"named":"(EmailOutbox: Record \"Email Outbox\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null}]},{"name":"OnBeforeOpenEmailEditor","sig":"(var Codeunit Email Message, Boolean)","named":"(var EmailMessage: Codeunit \"Email Message\"; IsNewEmail: Boolean)","returns":"","kind":"integrationevent","access":"internal","obsolete":null,"range":"20-29","first":20,"last":29,"obsoleteSince":null,"spans":[{"from":20,"to":29,"named":"(var EmailMessage: Codeunit \"Email Message\"; IsNewEmail: Boolean)","returns":"","kind":"integrationevent","access":"internal","obsolete":null}]},{"name":"OnBeforeSendEmail","sig":"(var Codeunit Email Message)","named":"(var EmailMessage: Codeunit \"Email Message\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null,"range":"20-29","first":20,"last":29,"obsoleteSince":null,"spans":[{"from":20,"to":29,"named":"(var EmailMessage: Codeunit \"Email Message\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null}]},{"name":"OnBeforeGetEmailAttachmentsByEmailScenarios","sig":"(Record Email Scenario Attachments)","named":"(EmailScenarioAttachments: Record \"Email Scenario Attachments\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null,"range":"23-25","first":23,"last":25,"obsoleteSince":null,"spans":[{"from":23,"to":25,"named":"(EmailScenarioAttachments: Record \"Email Scenario Attachments\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null}]},{"name":"OnEnqueuedReplyInOutbox","sig":"(Guid)","named":"(MessageId: Guid)","returns":"","kind":"integrationevent","access":"internal","obsolete":null,"range":"25-29","first":25,"last":29,"obsoleteSince":null,"spans":[{"from":25,"to":29,"named":"(MessageId: Guid)","returns":"","kind":"integrationevent","access":"internal","obsolete":null}]},{"name":"OnBeforeReplyEmail","sig":"(var Codeunit Email Message)","named":"(var EmailMessage: Codeunit \"Email Message\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null,"range":"25-29","first":25,"last":29,"obsoleteSince":null,"spans":[{"from":25,"to":29,"named":"(var EmailMessage: Codeunit \"Email Message\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null}]},{"name":"OnBeforeGetEmailAttachmentsByEmailScenarios","sig":"(var Record Email Scenario Attachments)","named":"(var EmailScenarioAttachments: Record \"Email Scenario Attachments\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null,"range":"26-29","first":26,"last":29,"obsoleteSince":null,"spans":[{"from":26,"to":29,"named":"(var EmailScenarioAttachments: Record \"Email Scenario Attachments\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null}]},{"name":"OnBeforeFilterRemovedSourceRecords","sig":"(var Record Email Related Record)","named":"(var EmailRelatedRecord: Record \"Email Related Record\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null,"range":"29","first":29,"last":29,"obsoleteSince":null,"spans":[{"from":29,"to":29,"named":"(var EmailRelatedRecord: Record \"Email Related Record\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null}]}]}