---
title: "Table 9500 Email Item"
author: "Jonas Paprotka"
url: https://jonas-paprotka.de/ref/table/9500-email-item/
type: table
id: 9500
name: "Email Item"
app: "Base Application"
namespace: System.EMail
versions: "17-28"
build: 28.5.54151.54365
source: "https://jonas-paprotka.de/ref/table/9500-email-item/source/29/"
checked: 2026-09-20
subject: "Microsoft Dynamics 365 Business Central"
license: "Content © 2026 Jonas Paprotka. Quote freely with attribution and a link."
---

# Table 9500 Email Item

Jonas Paprotka, https://jonas-paprotka.de/ref/table/9500-email-item/

| | |
| --- | --- |
| App | Base Application |
| Namespace | System.EMail |
| Versions | 17-28 |
| Source file | Modules/System/Email/EmailItem.Table.al |

## Fields

| Id | Name | Type | Versions | Obsolete | Reason |
| --- | --- | --- | --- | --- | --- |
| 1 | ID | Guid | 17-28 | - | - |
| 2 | From Name | Text[100] | 17-28 | - | - |
| 3 | From Address | Text[250] | 17-28 | - | - |
| 4 | Send to | Text[250] | 17-28 | - | - |
| 5 | Send CC | Text[250] | 17-28 | - | - |
| 6 | Send BCC | Text[250] | 17-28 | - | - |
| 7 | Subject | Text[250] | 17-28 | - | - |
| 8 | Body | Blob | 17-28 | - | - |
| 9 | Attachment File Path | Text[250] | 17-28 | Removed 28.0 | Replaced with method AddAttachment that accepts Streams. |
| 10 | Attachment Name | Text[250] | 17-28 | Removed 28.0 | Replaced with method AddAttachment that accepts Streams. |
| 11 | Plaintext Formatted | Boolean | 17-28 | - | - |
| 12 | Body File Path | Text[250] | 17-28 | Pending 27.0 | Replaced with field Body. You can use the new procedure SetBody to update the value of the html formatted body. |
| 13 | Message Type | Option | 17-28 | - | - |
| 14 | Send as HTML | Boolean | 18-28 | - | - |
| 21 | Attachment File Path 2 | Text[250] | 17-28 | Removed 28.0 | Replaced with method AddAttachment that accepts Streams. |
| 22 | Attachment Name 2 | Text[50] | 17-28 | Removed 28.0 | Replaced with method AddAttachment that accepts Streams. |
| 23 | Attachment File Path 3 | Text[250] | 17-28 | Removed 28.0 | Replaced with method AddAttachment that accepts Streams. |
| 24 | Attachment Name 3 | Text[50] | 17-28 | Removed 28.0 | Replaced with method AddAttachment that accepts Streams. |
| 25 | Attachment File Path 4 | Text[250] | 17-28 | Removed 28.0 | Replaced with method AddAttachment that accepts Streams. |
| 26 | Attachment Name 4 | Text[50] | 17-28 | Removed 28.0 | Replaced with method AddAttachment that accepts Streams. |
| 27 | Attachment File Path 5 | Text[250] | 17-28 | Removed 28.0 | Replaced with method AddAttachment that accepts Streams. |
| 28 | Attachment Name 5 | Text[50] | 17-28 | Removed 28.0 | Replaced with method AddAttachment that accepts Streams. |
| 29 | Attachment File Path 6 | Text[250] | 17-28 | Removed 28.0 | Replaced with method AddAttachment that accepts Streams. |
| 30 | Attachment Name 6 | Text[50] | 17-28 | Removed 28.0 | Replaced with method AddAttachment that accepts Streams. |
| 31 | Attachment File Path 7 | Text[250] | 17-28 | Removed 28.0 | Replaced with method AddAttachment that accepts Streams. |
| 32 | Attachment Name 7 | Text[50] | 17-28 | Removed 28.0 | Replaced with method AddAttachment that accepts Streams. |
| 33 | Source Table | Integer | 18-25 | Removed 18.1 | Replaced with method AddSourceDocument. |
| 34 | Source System Id | Guid | 18-25 | Removed 18.1 | Replaced with method AddSourceDocument. |

## Keys

| Name | Fields | Versions |
| --- | --- | --- |
| Key1, clustered | ID | 17-28 |

## Procedures

| Name | Parameters | Returns | Access | Versions | Obsolete | Reason |
| --- | --- | --- | --- | --- | --- | --- |
| HasAttachments | () | Boolean | public | 17-28 | - | - |
| GetAttachments | (var Codeunit Temp Blob List, var List) | - | public | 17-28 | - | - |
| SetAttachments | (Codeunit Temp Blob List, List) | - | public | 17-28 | - | - |
| AddAttachment | (InStream, Text) | - | public | 17-28 | - | - |
| Initialize | () | - | public | 17-28 | - | - |
| Send | (Boolean) | Boolean | public | 17-23 | Pending 17.0 | Replaced with the overload containing Email Scenario |
| Send | (Boolean, Enum Email Scenario) | Boolean | public | 17-28 | - | - |
| SetBodyText | (Text) | - | public | 17-28 | - | - |
| GetBodyText | () | Text | public | 17-28 | - | - |
| AddCcBcc | () | - | public | 17-23 | Pending 21.0 | Microsoft Invoicing has been discontinued. |
| AttachIncomingDocuments | (Code[20]) | - | public | 17-26 | - | - |
| ValidateTarget | () | - | public | 17-28 | - | - |
| AddSourceDocument | (Integer, Guid) | - | public | 18-28 | - | - |
| AddSourceDocument | (Integer, Guid, Enum Email Relation Type) | - | public | 18-28 | - | - |
| GetSourceDocuments | (var List, var List) | - | public | 18-21 | Pending 19.0 | Replaced by an overload that contains Relation Types. |
| GetSourceDocuments | (var List, var List, var List) | - | public | 18-28 | - | - |
| SetSourceDocuments | (List, List) | - | public | 18-21 | Pending 19.0 | Replaced by an overload that contains Relation Types. |
| SetSourceDocuments | (List, List, List) | - | public | 18-28 | - | - |
| SendAsHTML | (Boolean) | - | public | 18-28 | - | - |
| AddRelatedSourceDocuments | (Integer, Guid) | - | public | 19-22 | Pending 20.0 | Automatically added when calling AddSourceDocument |
| GetBodyTextFromBlob | () | Text | public | 22-28 | - | - |
| Send | (Boolean, Enum Email Scenario, Boolean) | Boolean | public | 23-28 | - | - |
| SetBody | (var Codeunit Temp Blob) | - | public | 27-28 | - | - |
| SetBody | (var Codeunit Temp Blob, Boolean) | - | public | 27-28 | - | - |

## Events

| Kind | Name | Parameters | Versions | Obsolete | Reason |
| --- | --- | --- | --- | --- | --- |
| Integration event | OnAttachIncomingDocumentsOnAfterSetFilter | (var Record Incoming Document Attachment) | 17-26 | - | - |
| Integration event | OnBeforeGetBodyText | (var Record Email Item, var Text, var Boolean) | 17-28 | - | - |
| Integration event | OnBeforeSend | (var Record Email Item, var Boolean, var Codeunit Mail Management) | 17-22 | - | - |
| Integration event | OnBeforeSetAttachments | (var Record Email Item, var Codeunit Temp Blob List, var List) | 21-28 | - | - |
| Integration event | OnBeforeSend | (var Record Email Item, var Boolean, var Codeunit Mail Management, Enum Email Scenario, var Boolean, var Boolean) | 23-26 | - | - |
| Integration event | OnBeforeSend | (var Record Email Item, var Boolean, var Codeunit Mail Management, var Enum Email Scenario, var Boolean, var Boolean, var Boolean) | 27-28 | - | - |

## Source

Symbols: Microsoft.BaseApplication.symbols.437dbf0e-84ff-417a-965d-ed2bb9650972, https://dynamicssmb2.pkgs.visualstudio.com/DynamicsBCPublicFeeds/_packaging/MSSymbols/nuget/v3/index.json, highest build per major on 2026-09-20.
AL source 29: https://github.com/microsoft/BCApps, MIT, releases/29.x at a66254c3b8b5bb1cea290dc8f9d097aec4381153.

Jonas Paprotka, 2026-09-20.