{"title":"Codeunit 8901 Email, changes","url":"https://jonas-paprotka.de/ref/codeunit/8901-email/changes/","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":"changes","total":60,"rows":[{"version":29,"kind":"procedure","change":"added","name":"FindRetrievedEmail","member":{"name":"FindRetrievedEmail","sig":"(Guid, Text, var Record Email Inbox)","named":"(EmailAccountId: Guid; ExternalMessageId: Text; var EmailInbox: Record \"Email Inbox\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}},{"version":29,"kind":"event","change":"added","name":"OnBeforeFilterRemovedSourceRecords","member":{"name":"OnBeforeFilterRemovedSourceRecords","sig":"(var Record Email Related Record)","named":"(var EmailRelatedRecord: Record \"Email Related Record\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"GetEmailCategories","member":{"name":"GetEmailCategories","sig":"(Guid, Enum Email Connector, var Record Email Categories)","named":"(EmailAccountId: Guid; EmailConnector: Enum \"Email Connector\"; var EmailCategories: Record \"Email Categories\" temporary)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"CreateEmailCategory","member":{"name":"CreateEmailCategory","sig":"(Guid, Enum Email Connector, Text)","named":"(EmailAccountId: Guid; EmailConnector: Enum \"Email Connector\"; CategoryDisplayName: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"CreateEmailCategory","member":{"name":"CreateEmailCategory","sig":"(Guid, Enum Email Connector, Text, Text)","named":"(EmailAccountId: Guid; EmailConnector: Enum \"Email Connector\"; CategoryDisplayName: Text; CategoryColor: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"ApplyEmailCategory","member":{"name":"ApplyEmailCategory","sig":"(Guid, Enum Email Connector, Text, Text)","named":"(EmailAccountId: Guid; EmailConnector: Enum \"Email Connector\"; ExternalId: Text; CategoryDisplayName: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"ApplyEmailCategory","member":{"name":"ApplyEmailCategory","sig":"(Guid, Enum Email Connector, Text, List)","named":"(EmailAccountId: Guid; EmailConnector: Enum \"Email Connector\"; ExternalId: Text; Categories: List of [Text])","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":27,"kind":"procedure","change":"added","name":"GetMailFolders","member":{"name":"GetMailFolders","sig":"(Guid, Enum Email Connector, var Record Email Folders)","named":"(EmailAccountId: Guid; EmailConnector: Enum \"Email Connector\"; var EmailFolders: Record \"Email Folders\" temporary)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":26,"kind":"event","change":"gone","name":"OnBeforeGetEmailAttachmentsByEmailScenarios","member":{"name":"OnBeforeGetEmailAttachmentsByEmailScenarios","sig":"(Record Email Scenario Attachments)","named":"(EmailScenarioAttachments: Record \"Email Scenario Attachments\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null}},{"version":26,"kind":"event","change":"added","name":"OnBeforeGetEmailAttachmentsByEmailScenarios","member":{"name":"OnBeforeGetEmailAttachmentsByEmailScenarios","sig":"(var Record Email Scenario Attachments)","named":"(var EmailScenarioAttachments: Record \"Email Scenario Attachments\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null}},{"version":25,"kind":"procedure","change":"added","name":"Reply","member":{"name":"Reply","sig":"(Codeunit Email Message, Text, Guid, Enum Email Connector)","named":"(EmailMessage: Codeunit \"Email Message\"; ExternalId: Text; EmailAccountId: Guid; EmailConnector: Enum \"Email Connector\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replaced by Reply without the ExternalId parameter. ExternalId is not used and is contained in the EmailMessage parameter.","tag":"26.0"}}},{"version":25,"kind":"procedure","change":"added","name":"ReplyAll","member":{"name":"ReplyAll","sig":"(Codeunit Email Message, Text, Guid, Enum Email Connector)","named":"(EmailMessage: Codeunit \"Email Message\"; ExternalId: Text; EmailAccountId: Guid; EmailConnector: Enum \"Email Connector\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replaced by ReplyAll without the ExternalId parameter. ExternalId is not used and is contained in the EmailMessage parameter.","tag":"26.0"}}},{"version":25,"kind":"procedure","change":"added","name":"EnqueueReply","member":{"name":"EnqueueReply","sig":"(Codeunit Email Message, Text, Guid, Enum Email Connector, var Record Email Outbox)","named":"(EmailMessage: Codeunit \"Email Message\"; ExternalId: Text; EmailAccountId: Guid; EmailConnector: Enum \"Email Connector\"; var EmailOutbox: Record \"Email Outbox\")","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replaced by EnqueueReply without the ExternalId parameter. ExternalId is not used and is contained in the EmailMessage parameter.","tag":"26.0"}}},{"version":25,"kind":"procedure","change":"added","name":"EnqueueReplyAll","member":{"name":"EnqueueReplyAll","sig":"(Codeunit Email Message, Text, Guid, Enum Email Connector, var Record Email Outbox)","named":"(EmailMessage: Codeunit \"Email Message\"; ExternalId: Text; EmailAccountId: Guid; EmailConnector: Enum \"Email Connector\"; var EmailOutbox: Record \"Email Outbox\")","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replaced by EnqueueReplyAll without the ExternalId parameter. ExternalId is not used and is contained in the EmailMessage parameter.","tag":"26.0"}}},{"version":25,"kind":"procedure","change":"added","name":"Reply","member":{"name":"Reply","sig":"(Codeunit Email Message, Guid, Enum Email Connector)","named":"(EmailMessage: Codeunit \"Email Message\"; EmailAccountId: Guid; EmailConnector: Enum \"Email Connector\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}},{"version":25,"kind":"procedure","change":"added","name":"ReplyAll","member":{"name":"ReplyAll","sig":"(Codeunit Email Message, Guid, Enum Email Connector)","named":"(EmailMessage: Codeunit \"Email Message\"; EmailAccountId: Guid; EmailConnector: Enum \"Email Connector\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}},{"version":25,"kind":"procedure","change":"added","name":"EnqueueReply","member":{"name":"EnqueueReply","sig":"(Codeunit Email Message, Guid, Enum Email Connector, var Record Email Outbox)","named":"(EmailMessage: Codeunit \"Email Message\"; EmailAccountId: Guid; EmailConnector: Enum \"Email Connector\"; var EmailOutbox: Record \"Email Outbox\")","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":25,"kind":"procedure","change":"added","name":"EnqueueReplyAll","member":{"name":"EnqueueReplyAll","sig":"(Codeunit Email Message, Guid, Enum Email Connector, var Record Email Outbox)","named":"(EmailMessage: Codeunit \"Email Message\"; EmailAccountId: Guid; EmailConnector: Enum \"Email Connector\"; var EmailOutbox: Record \"Email Outbox\")","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":25,"kind":"procedure","change":"added","name":"RetrieveEmails","member":{"name":"RetrieveEmails","sig":"(Guid, Enum Email Connector, var Record Email Inbox)","named":"(EmailAccountId: Guid; EmailConnector: Enum \"Email Connector\"; var EmailInbox: Record \"Email Inbox\")","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replaced by RetrieveEmails with an additional Filters parameter of type Record \"Email Retrieval Filters\".","tag":"26.0"}}},{"version":25,"kind":"procedure","change":"added","name":"RetrieveEmails","member":{"name":"RetrieveEmails","sig":"(Guid, Enum Email Connector, var Record Email Inbox, var Record Email Retrieval Filters)","named":"(EmailAccountId: Guid; EmailConnector: Enum \"Email Connector\"; var EmailInbox: Record \"Email Inbox\"; var Filters: Record \"Email Retrieval Filters\" temporary)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":25,"kind":"procedure","change":"added","name":"MarkAsRead","member":{"name":"MarkAsRead","sig":"(Guid, Enum Email Connector, Text)","named":"(EmailAccountId: Guid; EmailConnector: Enum \"Email Connector\"; ExternalId: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":25,"kind":"event","change":"added","name":"OnEnqueuedReplyInOutbox","member":{"name":"OnEnqueuedReplyInOutbox","sig":"(Guid)","named":"(MessageId: Guid)","returns":"","kind":"integrationevent","access":"internal","obsolete":null}},{"version":25,"kind":"event","change":"added","name":"OnBeforeReplyEmail","member":{"name":"OnBeforeReplyEmail","sig":"(var Codeunit Email Message)","named":"(var EmailMessage: Codeunit \"Email Message\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null}},{"version":24,"kind":"procedure","change":"added","name":"OpenSentEmails","member":{"name":"OpenSentEmails","sig":"(Integer, Guid, DateTime)","named":"(TableId: Integer; SystemId: Guid; NewerThanDate: DateTime)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":23,"kind":"procedure","change":"gone","name":"GetSentEmailsForRecord","member":{"name":"GetSentEmailsForRecord","sig":"(Integer, Guid)","named":"(TableId: Integer; SystemId: Guid)","returns":"Record Sent Email","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetSentEmailsForRecord(TableId: Integer; SystemId: Guid; var ResultEmailOutbox: Record \"Email Outbox\" temporary) instead.","tag":"19.0"}}},{"version":23,"kind":"procedure","change":"gone","name":"AddRelation","member":{"name":"AddRelation","sig":"(Codeunit Email Message, Integer, Guid, Enum Email Relation Type)","named":"(EmailMessage: Codeunit \"Email Message\"; TableId: Integer; SystemId: Guid; RelationType: Enum \"Email Relation Type\")","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use \"AddRelation(EmailMessage: Codeunit \"Email Message\"; TableId: Integer; SystemId: Guid; RelationType: Enum \"Email Relation Type\")\" with origin","tag":"20.0"}}},{"version":23,"kind":"event","change":"gone","name":"OnGetTestEmailBody","member":{"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"}}},{"version":23,"kind":"event","change":"gone","name":"OnAfterSendEmail","member":{"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"}}},{"version":23,"kind":"event","change":"added","name":"OnBeforeGetEmailAttachmentsByEmailScenarios","member":{"name":"OnBeforeGetEmailAttachmentsByEmailScenarios","sig":"(Record Email Scenario Attachments)","named":"(EmailScenarioAttachments: Record \"Email Scenario Attachments\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null}},{"version":22,"kind":"procedure","change":"added","name":"AddDefaultAttachments","member":{"name":"AddDefaultAttachments","sig":"(Codeunit Email Message, Enum Email Scenario)","named":"(EmailMessage: Codeunit \"Email Message\"; EmailScenario: Enum \"Email Scenario\")","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":21,"kind":"procedure","change":"added","name":"OpenInEditorModallyWithScenario","member":{"name":"OpenInEditorModallyWithScenario","sig":"(Codeunit Email Message, Record Email Account, Enum Email Scenario)","named":"(EmailMessage: Codeunit \"Email Message\"; EmailAccount: Record \"Email Account\" temporary; Scenario: Enum \"Email Scenario\")","returns":"Enum Email Action","kind":"procedure","access":"public","obsolete":null}},{"version":20,"kind":"procedure","change":"added","name":"SaveAsDraft","member":{"name":"SaveAsDraft","sig":"(Codeunit Email Message, Guid, Enum Email Connector, var Record Email Outbox)","named":"(EmailMessage: Codeunit \"Email Message\"; EmailAccountId: Guid; EmailConnector: Enum \"Email Connector\"; var EmailOutbox: Record \"Email Outbox\")","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":20,"kind":"procedure","change":"added","name":"Enqueue","member":{"name":"Enqueue","sig":"(Codeunit Email Message, DateTime)","named":"(EmailMessage: Codeunit \"Email Message\"; NotBefore: DateTime)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":20,"kind":"procedure","change":"added","name":"Enqueue","member":{"name":"Enqueue","sig":"(Codeunit Email Message, Enum Email Scenario, DateTime)","named":"(EmailMessage: Codeunit \"Email Message\"; EmailScenario: Enum \"Email Scenario\"; NotBefore: DateTime)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":20,"kind":"procedure","change":"added","name":"Enqueue","member":{"name":"Enqueue","sig":"(Codeunit Email Message, Record Email Account, DateTime)","named":"(EmailMessage: Codeunit \"Email Message\"; EmailAccount: Record \"Email Account\" temporary; NotBefore: DateTime)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":20,"kind":"procedure","change":"added","name":"Enqueue","member":{"name":"Enqueue","sig":"(Codeunit Email Message, Guid, Enum Email Connector, DateTime)","named":"(EmailMessage: Codeunit \"Email Message\"; EmailAccountId: Guid; EmailConnector: Enum \"Email Connector\"; NotBefore: DateTime)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":20,"kind":"procedure","change":"added","name":"OpenSentEmails","member":{"name":"OpenSentEmails","sig":"(Variant)","named":"(RecordVariant: Variant)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":20,"kind":"event","change":"marked","name":"OnAfterSendEmail","member":{"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"}}},{"version":20,"kind":"event","change":"added","name":"OnAfterEmailSent","member":{"name":"OnAfterEmailSent","sig":"(Record Sent Email)","named":"(SentEmail: Record \"Sent Email\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null}},{"version":20,"kind":"event","change":"added","name":"OnAfterEmailSendFailed","member":{"name":"OnAfterEmailSendFailed","sig":"(Record Email Outbox)","named":"(EmailOutbox: Record \"Email Outbox\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null}},{"version":20,"kind":"event","change":"added","name":"OnBeforeOpenEmailEditor","member":{"name":"OnBeforeOpenEmailEditor","sig":"(var Codeunit Email Message, Boolean)","named":"(var EmailMessage: Codeunit \"Email Message\"; IsNewEmail: Boolean)","returns":"","kind":"integrationevent","access":"internal","obsolete":null}},{"version":20,"kind":"event","change":"added","name":"OnBeforeSendEmail","member":{"name":"OnBeforeSendEmail","sig":"(var Codeunit Email Message)","named":"(var EmailMessage: Codeunit \"Email Message\")","returns":"","kind":"integrationevent","access":"internal","obsolete":null}},{"version":19,"kind":"procedure","change":"marked","name":"GetSentEmailsForRecord","member":{"name":"GetSentEmailsForRecord","sig":"(Integer, Guid)","named":"(TableId: Integer; SystemId: Guid)","returns":"Record Sent Email","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetSentEmailsForRecord(TableId: Integer; SystemId: Guid; var ResultEmailOutbox: Record \"Email Outbox\" temporary) instead.","tag":"19.0"}}},{"version":19,"kind":"procedure","change":"marked","name":"AddRelation","member":{"name":"AddRelation","sig":"(Codeunit Email Message, Integer, Guid, Enum Email Relation Type)","named":"(EmailMessage: Codeunit \"Email Message\"; TableId: Integer; SystemId: Guid; RelationType: Enum \"Email Relation Type\")","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use \"AddRelation(EmailMessage: Codeunit \"Email Message\"; TableId: Integer; SystemId: Guid; RelationType: Enum \"Email Relation Type\")\" with origin","tag":"20.0"}}},{"version":19,"kind":"procedure","change":"added","name":"GetSentEmailsForRecord","member":{"name":"GetSentEmailsForRecord","sig":"(Integer, Guid, var Record Sent Email)","named":"(TableId: Integer; SystemId: Guid; var ResultSentEmails: Record \"Sent Email\" temporary)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":19,"kind":"procedure","change":"added","name":"GetSentEmailsForRecord","member":{"name":"GetSentEmailsForRecord","sig":"(Variant, var Record Sent Email)","named":"(RecordVariant: Variant; var ResultSentEmails: Record \"Sent Email\" temporary)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":19,"kind":"procedure","change":"added","name":"GetEmailOutboxForRecord","member":{"name":"GetEmailOutboxForRecord","sig":"(Variant, var Record Email Outbox)","named":"(RecordVariant: Variant; var ResultEmailOutbox: Record \"Email Outbox\" temporary)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":19,"kind":"procedure","change":"added","name":"GetOutboxEmailRecordStatus","member":{"name":"GetOutboxEmailRecordStatus","sig":"(Guid)","named":"(MessageId: Guid)","returns":"Enum Email Status","kind":"procedure","access":"public","obsolete":null}},{"version":19,"kind":"procedure","change":"added","name":"AddRelation","member":{"name":"AddRelation","sig":"(Codeunit Email Message, Integer, Guid, Enum Email Relation Type, Enum Email Relation Origin)","named":"(EmailMessage: Codeunit \"Email Message\"; TableId: Integer; SystemId: Guid; RelationType: Enum \"Email Relation Type\"; Origin: Enum \"Email Relation Origin\")","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":19,"kind":"procedure","change":"added","name":"RemoveRelation","member":{"name":"RemoveRelation","sig":"(Codeunit Email Message, Integer, Guid)","named":"(EmailMessage: Codeunit \"Email Message\"; TableId: Integer; SystemId: Guid)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}},{"version":19,"kind":"procedure","change":"added","name":"HasRelations","member":{"name":"HasRelations","sig":"(Codeunit Email Message)","named":"(EmailMessage: Codeunit \"Email Message\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}},{"version":19,"kind":"event","change":"added","name":"OnAfterAddRelation","member":{"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}},{"version":19,"kind":"event","change":"added","name":"OnAfterRemoveRelation","member":{"name":"OnAfterRemoveRelation","sig":"(Guid, Integer, Guid)","named":"(EmailMessageId: Guid; TableId: Integer; SystemId: Guid)","returns":"","kind":"integrationevent","access":"internal","obsolete":null}},{"version":18,"kind":"procedure","change":"added","name":"GetSentEmailsForRecord","member":{"name":"GetSentEmailsForRecord","sig":"(Integer, Guid)","named":"(TableId: Integer; SystemId: Guid)","returns":"Record Sent Email","kind":"procedure","access":"public","obsolete":null}},{"version":18,"kind":"procedure","change":"added","name":"OpenSentEmails","member":{"name":"OpenSentEmails","sig":"(Integer, Guid)","named":"(TableId: Integer; SystemId: Guid)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":18,"kind":"procedure","change":"added","name":"AddRelation","member":{"name":"AddRelation","sig":"(Codeunit Email Message, Integer, Guid, Enum Email Relation Type)","named":"(EmailMessage: Codeunit \"Email Message\"; TableId: Integer; SystemId: Guid; RelationType: Enum \"Email Relation Type\")","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":18,"kind":"event","change":"added","name":"OnShowSource","member":{"name":"OnShowSource","sig":"(Integer, Guid, var Boolean)","named":"(SourceTableId: Integer; SourceSystemId: Guid; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"internal","obsolete":null}},{"version":18,"kind":"event","change":"added","name":"OnFindRelatedAttachments","member":{"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}},{"version":18,"kind":"event","change":"added","name":"OnGetAttachment","member":{"name":"OnGetAttachment","sig":"(Integer, Guid, Guid)","named":"(AttachmentTableID: Integer; AttachmentSystemID: Guid; MessageID: Guid)","returns":"","kind":"integrationevent","access":"internal","obsolete":null}},{"version":18,"kind":"event","change":"added","name":"OnEnqueuedInOutbox","member":{"name":"OnEnqueuedInOutbox","sig":"(Guid)","named":"(MessageId: Guid)","returns":"","kind":"integrationevent","access":"internal","obsolete":null}}]}