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

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.
  • Default value: 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.
  • Default value: false

IsHtmlBody

  • Type: boolean
  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update
  • Description: Required. Indicates whether the email body is in HTML format.
  • Default value: 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:
    • 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:
    • 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:
    • 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.