EmailMessage | Object Reference for Salesforce and Force.com

Supported Calls

create(), delete(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), undelete(), update()

Special Access Rules

Customer Portal users have read access to this object.

update() is supported only on records whose Status is Draft.

Fields

Field	Details
ActivityId	Type reference Properties Create, Filter, Group, Nillable, Sort Description ID of the activity that is associated with the email. Usually represents an open task that is created for the case owner when a new unread email message is received.
BccAddress	Type string Properties Create, Filter, Nillable, Sort, Update Description The addresses that were sent a blind carbon copy of the email.
CcAddress	Type string Properties Create, Filter, Nillable, Sort, Update Description The addresses that were sent a carbon copy of the email.
FromAddress	Type email Properties Create, Filter, Nillable, Update Description The address that originated the email.
FromName	Type string Properties Create, Filter, Nillable, Update Description The sender’s name.
HasAttachment	Type boolean Properties Defaulted on create, Filter Description Indicates whether the email was sent with an attachment (`true`) or not (`false`).
Headers	Type textarea Properties Create, Nillable, Update Description The Internet message headers of the incoming email. Used for debugging and tracing purposes. Does not apply to outgoing emails.
HtmlBody	Type textarea Properties Create, Nillable, Update Description The body of the email in HTML format.
Incoming	Type boolean Properties Create, Defaulted on create, Filter Description Indicates whether the email was received (`true`) or sent (`false`).
IsDeleted	Type boolean Properties Defaulted on create, Filter Description Indicates whether the object has been moved to the Recycle Bin (`true`) or not (`false`). Label is Deleted.
IsExternallyVisible	Type boolean Properties Create, Defaulted on create, Filter, Group, Update Description Controls the external visibility of email messages in communities, and is accessible only if the community case feed is enabled. When this field is set to true—its default value—email messages are visible to external users in the case feed.
MessageDate	Type dateTime Properties Create, Filter, Nillable, Update Description The date the email was created.
ParentId	Type ID Properties Create, Filter Description ID of the Case to which the email is associated.
ReplyToEmailMessageId	Type reference Properties Create, Filter, Group, Nillable, Sort Description ID of the inbound or outbound EmailMessage the current EmailMessage is a reply to. It’s not possible to reply to a message whose Status is `Draft`.
Status	Type picklist Properties Create, Filter, Restricted picklist Description Read only. The status of the email. For example, `New`, `Draft`, `Unread`, `Replied`, “`Sent`.”
Subject	Type string Properties Create, Filter, Nillable, Update Description The subject line of the email.
TextBody	Type textarea Properties Create, Nillable, Update Description The body of the email, in plain text format.
ToAddress	Type string Properties Create, Filter, Nillable, Update Description The address of the email’s recipient.

Usage

This object supports the Email-to-Case feature, which allows email sent to one of your company’s email addresses to automatically create a new case.