Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

EmailMessageRelation

Represents the relationship between an email and contacts, leads, and users. This object is available in API version 37.0 and later.

Special Access Rules

EmailMessageRelation is only available for organizations that use Email-to-Case or Enhanced Email, which is automatically enabled for most customers.

Supported Calls

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

Fields

Field Name	Details
EmailMessageId	Type reference Properties Create, Filter, Group, Sort Description The ID of the EmailMessage record. This is a relationship field. Relationship Name EmailMessage Relationship Type Lookup Refers To EmailMessage
DeliveryResponse	Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The delivery response from the email recipient. Possible values are: `SoftBounce` `HardBounce` `OutOfOffice` Available in API version 67.0 and later.
RelationAddress	Type string Properties Create, Filter, Group, Nillable, Sort Description The email address of the sender or recipient. If a record relates an email to an existing contact, lead, or user record in Salesforce, the value of RelationAddress is the current value of the email address. If the value is not set, it is auto-populated from RelationId. Note
RelationId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The RecordId of the sender or recipient. If a record relates an email to an email address that’s not associated with an existing contact, lead, or user record in Salesforce, the value of RelationId is null. Note This is a polymorphic relationship field. Relationship Name Relation Relationship Type Lookup Refers To Contact, Lead, User
RelationObjectType	Type string Properties Filter, Group, Nillable, Sort Description The API name of the object type of the RecordId in the RelationId field. It can be a contact, lead, or user.
RelationType	Type picklist Properties Create, Filter, Group, Restricted picklist, Sort Description The type of relationship the contact, lead, or user has with the email message. Possible values include: `ToAddress` `CcAddress` `BccAddress` `FromAddress` `OtherAddress` For an Experience Cloud site user who is not the sender of the email, no `BccAddress` relations are returned.

Usage

EmailMessageRelation allows an email to be related to contacts, leads, and users.

Object Reference for the Salesforce Platform

EmailMessageRelation

Special Access Rules

Supported Calls

Fields

Usage