---
schema_version: "1"
id: 6fe400ff95f899f0ec983cda9548fc274afbc88b34c43ee185ee0cc1dc12adec
title: UserEmailPreferredPersonShare
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_useremailpreferredpersonshare.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_useremailpreferredpersonshare.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 145daae4be1ce83dca71b233b20ac2135dfe9a8065c7d27c653fba9cd2df0d9c
description: Represents a sharing entry on a UserEmailPreferredPerson object. Sharing is not customizable for UserEmailPreferredPerson records.This object is available in API version 44.0 and later.
---
# UserEmailPreferredPersonShare

Represents a sharing entry on a UserEmailPreferredPerson object. Sharing is not customizable for UserEmailPreferredPerson records.This object is available in API version 44.0 and later.

You can only create, edit, and delete sharing entries for standard objects whose RowCause field is set to Manual. Sharing entries for standard objects with different RowCause values are created as a result of your Salesforce org’s sharing configuration and are read-only. For some sharing mechanisms, such as sharing sets, sharing entries aren’t stored at all.

![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png)

#### Note

While Salesforce currently maintains read-only sharing entries for multiple sharing mechanisms, it’s possible that we’ll stop storing certain share records to improve performance. As a best practice, don’t create customizations that rely on the availability of these sharing entries. Any changes to sharing behavior will be communicated before they occur.

## Supported Calls

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

## Fields

| Field | Details |
| --- | --- |
| AccessLevel | 
Type

picklist

Properties

Create, Filter,Group, Restricted picklist, Sort, Update

Description

Required. The level of access allowed. Values can be:

- All
- Edit
- Read

.



 |
| ParentId | 

Type

reference

Properties

Create, Filter,Group, Sort,

Description

Id of the parent record, if any.

This is a relationship field.

Relationship Name

Parent

Relationship Type

Lookup

Refers To

UserEmailPreferredPerson



 |
| RowCause | 

Type

picklist

Properties

Create, Filter,Group, Nillable, Restricted picklist, Sort,

Description

Required. Reason that this sharing entry exists. If you’re creating a sharing entry, the only permitted value is Manual. If no value is specified, the field defaults to Manual. All other RowCause values are read-only. After the sharing entry is created, this field can’t be edited. Valid values can include:

- Manual—The User or Group has access because a user with All access manually shared the record with them.
- Owner—The User is the owner of the record or is in a role above the record owner in the role hierarchy.





 |
| UserOrGroupId | 

Type

reference

Properties

Create, Filter,Group, Sort,

Description

Required. ID of the user or group that has been given access to the UserEmailPreferredPerson record. The UserOrGroupID is polymorphic. The label is User/Group Id.

This is a polymorphic relationship field.

Relationship Name

UserOrGroup

Relationship Type

Lookup

Refers To

Group, User



 |