Skip to content


Email entity (also known as EmailDto). When an SMTP email message is received by MailSlurp it is parsed. The body and attachments are written to disk and the fields such as to, from, subject etc are stored in a database. The body contains the email content. If you want the original SMTP message see the getRawEmail endpoints. The attachments can be fetched using the AttachmentController


Name Type Description Notes
Id Guid ID of the email entity
UserId Guid ID of user that email belongs to
InboxId Guid ID of the inbox that received the email
To List List of To recipient email addresses that the email was addressed to. See recipients object for names.
From string Who the email was sent from. An email address - see fromName for the sender name. [optional]
Sender Sender [optional]
Recipients EmailRecipients [optional]
ReplyTo string The replyTo field on the received email message [optional]
Cc List List of CC recipients email addresses that the email was addressed to. See recipients object for names. [optional]
Bcc List List of BCC recipients email addresses that the email was addressed to. See recipients object for names. [optional]
Headers Dictionary Collection of SMTP headers attached to email [optional]
Attachments List List of IDs of attachments found in the email. Use these IDs with the Inbox and Email Controllers to download attachments and attachment meta data such as filesize, name, extension. [optional]
Subject string The subject line of the email message as specified by SMTP subject header [optional]
Body string The body of the email message as text parsed from the SMTP message body (does not include attachments). Fetch the raw content to access the SMTP message and use the attachments property to access attachments. The body is stored separately to the email entity so the body is not returned in paginated results only in full single email or wait requests. [optional]
BodyExcerpt string An excerpt of the body of the email message for quick preview . [optional]
BodyMD5Hash string A hash signature of the email message using MD5. Useful for comparing emails without fetching full body. [optional]
IsHTML bool Is the email body content type HTML? [optional]
Charset string Detected character set of the email body such as UTF-8 [optional]
Analysis EmailAnalysis [optional]
CreatedAt DateTime When was the email received by MailSlurp
UpdatedAt DateTime When was the email last updated
Read bool Read flag. Has the email ever been viewed in the dashboard or fetched via the API with a hydrated body? If so the email is marked as read. Paginated results do not affect read status. Read status is different to email opened event as it depends on your own account accessing the email. Email opened is determined by tracking pixels sent to other uses if enable during sending. You can listened for both email read and email opened events using webhooks.
TeamAccess bool Can the email be accessed by organization team members
Html bool [optional]

[Back to Model list] [Back to API list] [Back to ]