LifeScienceEmail

Represents a collection of sendable messages that manages the creation, sending, and tracking of email communications. This object stores the details of each email, including the content, the status of sending attempts, and any responses received. This object is available in API version 65.0 and later.

Supported Calls

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

Fields

Field	Details
AttachmentIdentifiers	Type textarea Properties Create, Nillable, Update Description A semicolon-separated list of IDs for attachments that need to be sent with the email transaction. This denormalized field displays the attachment names from the content document, allowing for additional attachments to be tracked and sent along with the email.
AttachmentNames	Type textarea Properties Create, Nillable, Update Description A list of attachment names that were selected for the email template. This is a denormalized field (simplified view) that pulls data from the content document to display the names of the attachments included with the email.
BccEmailAddressList	Type textarea Properties Create, Nillable, Update Description A list of email addresses in .csv format that are copied from the email template and included in the bcc field of the email.
BodyAttachmentIdentifier	Type string Properties Create, Filter, Group, Sort, Update Description Required. Stores the Salesforce ID of the standard attachment or content version record that contains the formatted content of the email body. This ensures the email body is properly linked and formatted when the email is sent.
BouncedDate	Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The date and time when the email is marked as bounced, indicating that it couldn’t be delivered to the recipient.
BouncedReason	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The reason why the email bounced, providing insight into the delivery failure (for example, invalid email address, mailbox full, or server issues).
CancelledDateTime	Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The date and time when the email is canceled.
CcEmailAddressList	Type textarea Properties Create, Nillable, Update Description A list of email addresses to be included in the cc field when sending the email. These recipients will receive a copy of the email but aren’t the primary recipients.
CommSubscriptionConsentId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description A lookup field that links the email transaction to the consent record that indicates whether the recipient opted into or out of receiving emails. This field is a relationship field. Relationship Name CommSubscriptionConsent Refers To CommSubscriptionConsent
EmailLanguage	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Specifies the language in which the linked email template is written.
EmailStatus	Type string Properties Filter, Group, Nillable, Sort Description Displays the status of the email based on recipient actions or system updates (Sent, Scheduled, Cancelled, Opened, Bounced). This field is a calculated field.
EmailTemplateId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description A lookup field that links the email transaction to the related email template used for the communication. This field is a relationship field. Relationship Name EmailTemplate Refers To LifeSciEmailTemplate
ErrorMessage	Type textarea Properties Create, Nillable, Update Description The error message generated if there was an issue sending the email.
FailedAttemptCount	Type double Properties Create, Filter, Nillable, Sort, Update Description The number of failed attempts made to send the email.
FirstOpenedDate	Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The date and time when the email is first opened by the recipient.
FromUserEmailAddress	Type email Properties Create, Filter, Group, Nillable, Sort, Update Description The user email address from which the email is sent. If you use an org-wide email address, emails are sent from that address instead.
IsBounced	Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether an email has bounced. The default value is `false`.
IsConsentIgnored	Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates that recipient consent preferences are ignored when the email is sent. The default value is `false`.
IsHtmlBody	Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Required. Indicates whether the email body is in HTML format. The default value is `false`.
LastEventDateTime	Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The date and time when the status information related to the email was last updated.
LastOpenedDate	Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The date and time when the email is last opened by the recipient.
LastReferencedDate	Type dateTime Properties Filter, Nillable, Sort Description The timestamp when the current user last accessed this record indirectly, for example, through a list view or related record.
LastViewedDate	Type dateTime Properties Filter, Nillable, Sort Description The timestamp when the current user last viewed this record or list view. If this value is null, and LastReferenceDate isn’t null, the user accessed this record or list view indirectly.
Name	Type string Properties Autonumber, Defaulted on create, Filter, idLookup, Sort Description Required. An automatically generated unique identifier for the record in the format ET-{0000000000}.
OwnerId	Type reference Properties Create, Defaulted on create, Filter, Group, Sort, Update Description ID of the owner or creator of this object. This field is a polymorphic relationship field. Relationship Name Owner Refers To Group, User
PresentationId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description A lookup field that links the email transaction to a specific presentation that the sales representative attaches as an email attachment. This field stores the reference to the presentation that must be included in the email as an attachment, ensuring the correct presentation is sent with the email. This field is a relationship field. Relationship Name Presentation Refers To Presentation
ResponseStatus	Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Tracks the recipient's response to an RSVP request from the .ics (iCalendar) tracking service. Possible values are: `Accepted` `Declined` `Tentative`
ScheduledDateTime	Type dateTime Properties Create, Filter, Nillable, Sort, Update Description Specifies the date and time when the email is scheduled to be sent. This allows the email to be delivered at the most appropriate or strategic timing, ensuring better engagement and relevance for the recipient.
SenderEmailAddress	Type email Properties Create, Filter, Group, Nillable, Sort, Update Description This field stores the final sender's email address after evaluating different possible sources. It can be either the user's email or an organization-wide email address, depending on the scenario. Unlike FromEmail, which might be directly associated with the individual user, SenderEmailAddress can be a standard organizational email (for example, no-reply) if configured.
SenderTerritoryId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description A lookup field that links to the territory of the user who sent the email. This field is a relationship field. Relationship Name SenderTerritory Refers To Territory2
SenderUserId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description A lookup field that links to the user who sent the email. This field tracks the specific individual responsible for sending the email. This field is a relationship field. Relationship Name SenderUser Refers To User
SenderUserName	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Stores the final sender's name after evaluating various potential sources. The value is determined based on the FromUser and the email settings, and is populated in the system code (EmailQueueSenderHandler.cls). The sender’s name can be derived from either the user’s details or an organization-wide email configuration, depending on the email context.
SentDateTime	Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The exact date and time when the email was sent.
SentToContactPointEmailId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The contact point email address that the email was sent to. Derived from the associated contact point email (ContactPointEmail object). Opt information is derived from the associated communication subscription consent (CommSubscriptionConsent object). This field is a relationship field. Relationship Name SentToContactPointEmail Refers To ContactPointEmail
SentToEmailAddress	Type email Properties Create, Filter, Group, Nillable, Sort, Update Description The email address where the email is sent. This field captures the recipient's email address. For automated emails, the recipient's email is stored in this field.
SourceReferenceRecordId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description A polymorphic lookup field that links the email transaction to a specific record from various objects, such as Provider Visit or Task. This allows the email transaction to be associated with the relevant event or task, providing context and traceability for the communication. This field is a polymorphic relationship field. Relationship Name SourceReferenceRecord Refers To DigitalSignatureRequest, ProviderVisit, Task
SourceSystemIdentifier	Type string Properties Create, Filter, Group, idLookup, Nillable, Sort, Update Description An external ID from the source system for data integrations.
SourceSystemName	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The name of the source system for data integrations.
Status	Type picklist Properties Create, Filter, Group, Restricted picklist, Sort, Update Description Required. Indicates the status of the email request. Possible values are: `Cancelled` `Failed` `New` `Preparing` `Retry` `Success`
SubjectText	Type string Properties Create, Filter, Group, Sort, Update Description Required. The subject line of the email, providing a summary of the content or purpose of the message. The subject is visible to recipients in their inbox.
ToAccountId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description Required. A reference to the account as the message recipient. This field is a relationship field. Relationship Name ToAccount Refers To Account
ToContactId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description A lookup field that references the contact as the email recipient. This field is necessary to track recipient-specific events, such as bounced emails, based on the contact’s information. This field is a relationship field. Relationship Name ToContact Refers To Contact
UrgencyType	Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Indicates the urgency of the email, determining when it should be sent. Possible values are: `Immediate` `Scheduled`

Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

LifeScienceEmailChangeEvent: Change events are available for the object.
LifeScienceEmailFeed: Feed tracking is available for the object.
LifeScienceEmailHistory: History is available for tracked fields of the object.
LifeScienceEmailShare: Sharing is available for the object.

Life Sciences Cloud Developer Guide

LifeScienceEmail

Supported Calls

Fields

Associated Objects