OpportunityShare

Represents a sharing entry on an Opportunity.

Supported Calls

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

Fields

Field	Field Type	Field Properties	Description
IsDeleted	boolean	Defaulted on create Filter	Indicates whether the record has been moved to the Recycle Bin (`true`) or not (`false`). Label is Deleted.
OpportunityAccessLevel	picklist	Create Filter Restricted picklist Update	Level of access that the user or group has to the opportunity. The possible values are: Read Edit All (This value is not valid for `delete()`, `create()`, or `update()` calls.) This field must be set to an access level that is higher than the organization’s default access level for opportunities.
OpportunityId	reference	Create Filter	ID of the Opportunity associated with this sharing entry. This field cannot be updated. For information on IDs, see ID Field Type.
RowCause	picklist	Filter Restricted picklist	Reason that this sharing entry exists. Read-only. Valid values include: Owner—User is the owner of the opportunity or is in a UserRole above the opportunity owner in the role hierarchy. Manual—User or group has access because a user with “All” access manually shared the opportunity with them. Rule—User or group has access via an opportunity sharing rule. ImplicitChild—User or group has access to the opportunity on the Account associated with this Opportunity. Team—User has access to the opportunity because she or he is on the sales team for the opportunity. The OpportunityTeamMember object for this opportunity sets the access level. See OpportunityTeamMember for more information.
UserOrGroupId	reference	Create Filter	ID of the User or Group that has been given access to the opportunity. This field cannot be updated.

Usage

This object allows you to determine which users and groups can view or edit opportunities owned by other users. For more information, see Sharing.

If you attempt to create a record that matches an existing record, the create() call updates any modified fields and returns the existing record.