---
schema_version: "1"
id: dbac349d251cf78735c17ba3d2789d923312c701dd54a9fcd01e776873bb5834
title: UserEmailPreferredPerson
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_useremailpreferredperson.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_useremailpreferredperson.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: dcb2b928df18afa5da218363c6a30c3a74e024a56472aba9bf11df1422750268
description: 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.
---
# 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](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_change_event.htm "A ChangeEvent object is available for each object that supports Change Data Capture. You can subscribe to a stream of change events using Change Data Capture to receive data tied to record changes in Salesforce. Changes include record creation, updates to an existing record, deletion of a record, and undeletion of a record. A change event isn’t a Salesforce object—it doesn’t support CRUD operations or queries. It’s included in the object reference so you can discover which Salesforce objects support change events.") (API version 62.0)

Change events are available for the object.

[UserEmailPreferredPersonShare](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_share.htm "StandardObjectNameShare is the model for all share objects associated with standard objects. These objects represent a sharing entry on the standard object.")

Sharing is available for the object.