--- schema_version: "1" id: 84537e60b1a67c63d0edabd6dba2f2b66e463f5f80b6b890071d033dfefbdb2b title: AccountShare collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_accountshare.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_accountshare.htm source_site: developer.salesforce.com content_type: documentation content_hash: f8cd9ead46b41e53a452554c3c3f1304c6f340b91abbab42d3fa723e0484a99e description: Represents a sharing entry on an account. --- # AccountShare Represents a sharing entry on an account. 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() ## Special Access Rules As of Summer ’20 and later, only users with access to the Account object can access this object. Customer Portal users can't access this object. ## Fields The properties available for some fields depend on the default org-wide sharing settings. The properties listed are true for the default settings of such fields. | Field | Details | | --- | --- | | AccountAccessLevel | Type picklist Properties Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update Description Level of access that the User or Group has to the Account. The possible values are: - Read - Edit - All (This value isn't 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 | Type reference Properties Create, Filter, Group, Sort Description ID of the Account associated with this sharing entry. This field can't be updated. This is a relationship field. Relationship Name Account Relationship Type Lookup Refers To Account | | CaseAccessLevel | Type picklist Properties Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update Description 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 can't be updated via the API if the AccountAccessLevel field is set to All. You can't update this field for the associated account owner via the API. You must update the account owner’s CaseAccessLevel via the Salesforce user interface. | | ContactAccessLevel | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description 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 can't be updated via the API if the ContactAccessLevel field is set to “Controlled by Parent.” You can't update this field for the associated account owner using the API. You must update the account owner’s ContactAccessLevel via the Salesforce user interface. | | OpportunityAccessLevel | Type picklist Properties Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update Description 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 opportunity access level. This field can’t be updated via the API if the AccountAccessLevel field is set to All. You can't use the API to update this field for the associated Account owner. You must update the Account owner’s opportunityAccessLevel via the Salesforce user interface. | | RowCause | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort Description 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 include: - Manual—The User or Group has access because a User with “All” access manually shared the Account with the user or group. - Owner—The User is the owner of the Account - Team—The User or Group has team access (is an AccountTeamMember). - Rule—The User or Group has access via an Account sharing rule. - GuestRule—The user or group has access via an Account guest user sharing rule. - ImplicitParent—The User or Group has access because they’re the owner of or have sharing access to records related to the account, such as opportunities, cases, contacts, contracts, or orders. - GuestParentImplicit—The guest user has access because they have access to records related to the Account, such as opportunities, cases, contacts, contracts, or orders. - LpuParentImplicit—The User has access because they have access to records related to the Account, which are owned by high-volume Experience Cloud site users and shared via a share group. - LpuImplicit—The User has access to records owned by high-volume Experience Cloud site users via a share group. - PortalImplicit—The Account is associated with the portal user. - ARImplicit—The User, who belongs to a partner or customer account, has access to the Account via an account relationship data sharing rule. - Territory2AssociationManual—With Sales Territories in API version 44.0 and earlier, the TerritoryManual reason code was written to AccountShare records when you manually assigned an account to a territory. In API version 45.0 and later, Territory2AssociationManual replaces all instances of TerritoryManual, and the Territory2AssociationManual reason code is written to AccountShare records when you manually assign an account to a territory. - Territory—The territory has access via a territory assignment rule. - TerritoryManual—Deprecated starting in API version 45.0 and replaced by the Territory2AssociationManual value. | | UserOrGroupId | Type reference Properties Create, Filter, Group, Sort Description ID of the User or Group that has been given access to the Account. This field can't be updated. This is a polymorphic relationship field. Relationship Name UserOrGroup Relationship Type Lookup Refers To Group, User | ## Usage This object allows you to determine which users and groups can view or edit Account records owned by other users. If you attempt to create an AccountShare record that matches an existing record, the request updates any modified fields and returns the existing record. For example, the following code finds all accounts owned by a user and manually shares them to a portal user. QueryResult result = conn.query("SELECT Id FROM Account WHERE OwnerId = '005D0000001LPFB'"); // Create a new AccountShare object List shares = new ArrayList(); for (SObject rec : result.getRecords()) { AccountShare share = new AccountShare(); share.setAccountId(rec.getId()); //Set the portal user Id to share the accounts with share.setUserOrGroupId("003D000000QA8Tl"); share.setAccountAccessLevel("Edit"); share.setOpportunityAccessLevel("Read"); share.setCaseAccessLevel("Edit"); shares.add(share); } conn.create(shares.toArray(new AccountShare\[shares.size()\])); This code shares the accounts that the user owns at the time, but not those accounts that are owned later. For these types of shares, use an owner-based sharing rule, such as [AccountOwnerSharingRule](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_accountownersharingrule.htm "Represents the rules for sharing an account with a User other than the owner."). If an account is shared in multiple ways with a user, you don’t always see multiple sharing records. If a user has access to an account for one or more of the following RowCause values, the records in the AccountShare object are compressed into one record with the highest level of access. - ImplicitParent - Manual - Owner #### See Also - [Account](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_account.htm "Represents an individual account, which is an organization or person involved with your business (such as customers, competitors, and partners).") - [CaseShare](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_caseshare.htm "Represents a sharing entry on a Case.") - [LeadShare](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_leadshare.htm "Represents a sharing entry on a Lead.") - [OpportunityShare](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_opportunityshare.htm "Represents a sharing entry on an Opportunity.")