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.

UserEmailPreferredPerson

Represents a mapping for a user’s preferred record for an email address when multiple records match an email field.This object is available in API version 44.0 and later.

Supported Calls

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

Special Access Rules

As of Summer ‘20 and later, only authenticated internal and external users can access this object.

Fields

Field	Details
Email	Type email Properties Create, Filter,Group, idLookup, Sort, Update Description Required. The unique email the mapping applies to. This field is unique for each user.
Name	Type string Properties Autonumber, Defaulted on create, Filter, idLookup, Sort Description Read-only. Auto-generated field.
OwnerId	Type reference Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Required. The userId that owns the record. Each record is only accessible to the owner. This is a polymorphic relationship field. Relationship Name Owner Relationship Type Lookup Refers To Group, User
PersonRecordId	Type reference Properties Create, Filter, Group, Sort, Update Description Required. The recordId of a contact, lead, or user that represents the preferred record for the email address. Use cascade delete for contact and lead, and delete if the personId is a deactivated user record. This is a polymorphic relationship field. Relationship Name PersonRecord Relationship Type Lookup Refers To Contact, Lead, User

Associated Objects

This object has the following associated objects. Unless noted, they are available in the same API version as this object.

UserEmailPreferredPersonChangeEvent (API version 62.0): Change events are available for the object.
UserEmailPreferredPersonShare: Sharing is available for the object.

Object Reference for the Salesforce Platform

UserEmailPreferredPerson

Supported Calls

Special Access Rules

Fields

Associated Objects