AccountShare

Supported Calls

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

Special Access Rules

Customer Portal users cannot access this object.

Fields

Field	Field Type	Field Properties	Description
AccountAccessLevel	picklist	Create Filter Restricted picklist Update	Level of access that the User or Group has to the Account. The possible values are: Read Edit All (This value is not valid for `create()` or `update()` calls.) This field must be set to an access level that is at least equal to the organization’s default Account access level. In addition, either this field, the OpportunityAccessLevel field, or the CaseAccessLevel field must be set higher than the organization’s default access level.
AccountId	reference	Create Filter	ID of the Account associated with this sharing entry. This field cannot be updated. For information on IDs, see ID Field Type.
CaseAccessLevel	picklist	Create Defaulted on create Filter Restricted picklist Update	Level of access that the User or Group has to cases associated with the account. The possible values are: None Read Edit This field must be set to an access level that is at least equal to the organization’s default CaseAccessLevel. This field cannot be updated via the API if the AccountAccessLevel field is set to “All.” You cannot update this field for the associated account owner via the API. You must update the account owner’s CaseAccessLevel via the Salesforce.com user interface.
ContactAccessLevel	picklist	Create Defaulted on create Filter Restricted picklist Update	Level of access that the User or Group has to contacts associated with the account. The possible values are: None Read Edit This field must be set to an access level that is at least equal to the organization’s default ContactAccessLevel. This field cannot be updated via the API if the ContactAccessLevel field is set to “Controlled by Parent,” you cannot update this field for the associated account owner using the API. You must update the account owner’s ContactAccessLevel via the Salesforce.com user interface.
IsDeleted	boolean	Defaulted on create Filter	Indicates whether the object 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 opportunities associated with the Account. The possible values are: None Read Edit This field must be set to an access level that is at least equal to the organization’s default opportunityAccessLevel. This field cannot be updated via the API if the AccountAccessLevel field is set to “All.” You cannot use the API to update this field for the associated Account owner. You must update the Account owner’s opportunityAccessLevel via the Salesforce.com user interface.
RowCause	picklist	Filter Restricted picklist	Reason that this sharing entry exists. Read-only. There are many possible values, including: Manual Sharing - The User or Group has access because a User with “All” access manually shared the Account with them. Owner - The User is the owner of the Account or is in a Role above the Account owner in the role hierarchy. Sales Team—The User or Group has team access (is an AccountTeamMember). Sharing Rule—The User or Group has access via an Account sharing rule.
UserOrGroupId	reference	Create Filter	ID of the User or Group that has been given access to the Account. This field cannot be updated.

Usage

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

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