Mail Models
Overview
This page describes the mail models returned by workflow email activities such as Read IMAP Email and Read Outlook Email.
These models can be bound through the Process Data drawer and used by downstream workflow activities.
Email
Represents a single email message returned by email read activities.
Returned by:
- Read IMAP Email
- Read Outlook Email
Properties
| Property | Type | Description |
|---|---|---|
| From | String | Sender email address. |
| Sender | String | Sender display name or sender header value. |
| To | String | Recipient email addresses. |
| Cc | String | CC recipient email addresses. |
| Bcc | String | BCC recipient email addresses. |
| ReplyTo | String | Reply-To email addresses. |
| Subject | String | Email subject. |
| TextBody | String | Plain-text content of the email. |
| HtmlBody | String | HTML content of the email. |
| SentAt | DateTime | Date and time the email was sent. |
| ReceivedAt | DateTime | Date and time the email was received. |
| Priority | String | Email priority. |
| InReplyTo | String | In-Reply-To header value. |
| References | String | References header value. |
| MessageId | String | Provider message identifier. |
| InternalId | String | Provider-specific internal identifier (for example, IMAP UID or Outlook Graph message ID). |
| Attachments | List<EmailAttachment> | Attachments associated with the email. |
EmailAttachment
Represents a single attachment within an email.
Returned through:
- Email.Attachments
Properties
| Property | Type | Description |
|---|---|---|
| FileName | String | Attachment file name. |
| ContentType | String | Attachment MIME type (for example, application/pdf or image/png). |
| Size | Int64 | Attachment size in bytes. |
| AttachmentReference | String | Serialized AttachmentReference used by attachment retrieval activities. |
| File | FileReference | File handle that can be passed directly to file-consuming activities. See File Reference. |
Usage Notes
- Use AttachmentReference with attachment retrieval activities such as Get IMAP Email Attachment and Get Outlook Email Attachment.
- Use File when passing attachments directly to activities that accept a File Reference.
- Use Add To Collection to build a
FileReference[]for activities that accept multiple files.
AttachmentReference
Identifies a specific attachment within a mailbox message.
This object is serialized into EmailAttachment.AttachmentReference as a JSON string.
Properties
| Property | Type | Description |
|---|---|---|
| ConnectionName | String | Email connection used to read the message. |
| ServerType | String | Email server type (IMAP or Outlook). |
| MessageIdentifier | String | IMAP UID or Outlook Graph message ID. |
| AttachmentIndex | Int32? | Attachment index for IMAP messages. |
| AttachmentId | String | Attachment identifier for Outlook messages. |
Usage Notes
Pass the AttachmentReference value to: