For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dev Portal
DocsAPI ReferenceLearnCommunityChangelog
DocsAPI ReferenceLearnCommunityChangelog
    • About Our APIs
  • REST
    • Overview
      • Overview
      • Storefront
          • Authentication
          • Catalog
          • Company
          • Orders
          • Request for Quote
          • Sales Rep
          • Shopping List
          • Store Settings
      • Management
  • GraphQL
    • Overview
  • MCP
    • Overview
Dev Portal
LogoLogo
On this page
  • Super Admins and Account Hierarchy
  • Company access scoping
RESTB2BStorefront

Super Admin

Was this page helpful?
Previous

Get Quote Store Info

Next

Get Super Admin's Assigned Companies

Built with

B2B Edition makes use of “Super Admin” accounts that generally serve one of several purposes, but may be used as needed. Some examples include:

  • Sales representatives who act on behalf of one or more Company accounts
  • Secondary account managers who are restricted from accessing the BigCommerce control panel

Super Admins and Account Hierarchy

Companies within Account Hierarchies restrict Super Admin access to some data. Super Admins may not access aggregate data such as subsidiary orders and users for the Account Hierarchy. In addition, if a Super Admin needs to masquerade as a subsidiary Company, they will need to be explicitly assigned to the subsidiary.

Note: For stores without Account Hierarchies enabled, Super Admins may be used as a workaround to provide storefront administrator access to a user for more than one Company account, essentially allowing the user to serve as an account owner for their assigned Companies.

For more general information about Super Admins, refer to Companies (Help Center).

The storefront endpoints provided for Super Admins have limited scope. For more advanced management of specific Super Admin, use the Server-to-Server Super Admin API.

Company access scoping

Sales reps acting on the storefront can only access companies they are directly assigned to. Assignments are explicit and do not traverse the Account Hierarchy — assigning a sales rep to a parent Company does not grant access to its subsidiaries. Each subsidiary the sales rep needs to act on must be assigned individually.

When a request to a Companies and Users endpoint targets a companyId the sales rep is not directly assigned to, the API returns 403 Permission denied. A non-integer companyId returns 400 Invalid companyId.

To assign a sales rep to one or more companies, use the Server-to-Server Super Admin API.