> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# Company Management

A Company in B2B Edition is the business account for B2B clients, which connects buyers in the business within its instance of the Buyer Portal.

BigCommerce customer groups determine the products and pricing that a Company's buyers see. Assign Company accounts to these groups as needed. Multiple Companies may share the same customer group, or remain unassigned to access the default catalog and pricing. The `customerGroupId` field maps Companies to customer groups.

**NOTE:** If your store uses legacy Dependent Companies behavior, each Company account has a one-to-one relationship with a BigCommerce customer group. Once created, you cannot reassign the Company to another customer group; you can only delete it. See [Companies and Customer Groups in B2B Edition (Help Center)](https://support.bigcommerce.com/s/article/Companies-and-Customer-Groups) to learn more about how Independent and Dependent Company behaviors work.

### Available Resources

| Resource                                                                                                            | Description                                                                 |
| ------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| [Companies](/developer/api-reference/rest/b2b/management/company/companies)                                         | Account details, settings, and attachments for B2B Edition Companies        |
| [Company Roles and Permissions](/developer/api-reference/rest/b2b/management/company/company-roles-and-permissions) | User roles and permissions for B2B buyers associated with a Company account |
| [Account Hierarchies](/developer/api-reference/rest/b2b/management/company/account-hierarchies)                     | Parent-child relationships between companies in a hierarchy                 |

### Company Status Codes

The `companyStatus` object indicates the activity status of a particular Company account in the response body of the following endpoints:

* Get All Companies (can also be used as a parameter in the query)
* Get Company Details
* Update a Company's Status

This is expressed as a `string` or `integer`, with numeric values that correspond to a possible status. See the table below for more information:

| Value | Company Status | Description                                                                            |
| ----- | -------------- | -------------------------------------------------------------------------------------- |
| 0     | Pending        | A buyer has applied for a Company account, but the application has not been processed. |
| 1     | Approved       | The Company account is active.                                                         |
| 2     | Rejected       | The application has been rejected and the Company account cannot be used.              |
| 3     | Inactive       | The Company account does not have any buyers assigned to it.                           |

### Company Account Hierarchy

Account Hierarchy functionality establishes parent-child relationships between multiple Company accounts belonging to a single client business. Buyers assigned to Companies on higher layers can access the Buyer Portal for their subsidiaries. This functionality allows you to support clients with complex businesses, such as chain stores, franchises, and global corporations.

**NOTE:** This functionality comes enabled by default on all new B2B Edition stores. It is also available upon request for existing stores using the Buyer Portal experience and Independent Companies behavior. You can request Account Hierarchy by contacting our support team.

You can create up to **5 layers** of hierarchy for a given organization, and each hierarchy can have a maximum of **500 Companies** assigned to it.

### Company Roles and Permissions

Buyers in a Company account, or *Company users*, are assigned a role that determines what they can view and configure within the Buyer Portal. B2B Edition includes predefined Company user roles, but you can also create custom roles with a unique set of permissions.

Additionally, you can use the Company Roles and Permissions API to create custom permissions for more complex role-based access control. Note that custom permissions are **not** configurable from the B2B Edition control panel.