> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/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. > Build amazing commerce solutions powered by the BigCommerce platform ## Docs - [Company Management](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/companies.md) ## API Docs - Account Hierarchies [List Company Subsidiaries](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/account-hierarchies/get-companies-company-id-subsidiaries.md) - Account Hierarchies [Delete Company Subsidiary](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/account-hierarchies/delete-companies-company-id-subsidiary.md) - Account Hierarchies [Attach Company as The Parent of Current Company](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/account-hierarchies/post-companies-company-id-parents.md) - Account Hierarchies [List Company Hierarchy](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/account-hierarchies/get-companies-company-id-hierarchy.md) - Companies [List Companies](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/companies/get-companies.md) - Companies [Create Company](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/companies/post-companies.md) - Companies [Get Company Details](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/companies/get-companies-company-id.md) - Companies [Update Company](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/companies/put-companies-company-id.md) - Companies [Delete Company](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/companies/delete-companies-company-id.md) - Companies [Convert BigCommerce Customer Group into Company](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/companies/post-companies-conversion-customer-groups.md) - Companies [Bulk Create Companies](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/companies/post-companies-bulk.md) - Companies [Update Companies (batch)](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/companies/put-companies.md) - Companies [Update Company Catalog](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/companies/put-companies-company-id-catalog.md) - Companies [Update Company Status](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/companies/put-companies-company-id-status.md) - Companies [List Company Extra Field Configs](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/companies/get-companies-extra-fields.md) - Companies [List Company Attachments](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/companies/get-companies-company-id-attachments.md) - Companies [Add Company Attachment](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/companies/post-companies-company-id-attachments.md) - Companies [Delete Company Attachment](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/companies/delete-companies-company-id-attachments-attachment-id.md) - Company Roles and Permissions [List Company Permissions](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/company-roles-and-permissions/get-stores-companies-permissions.md) - Company Roles and Permissions [Create Company Permission](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/company-roles-and-permissions/post-stores-companies-permissions.md) - Company Roles and Permissions [Update Company Permission](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/company-roles-and-permissions/put-stores-companies-permissions-permission-id.md) - Company Roles and Permissions [Delete Company Permission](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/company-roles-and-permissions/delete-stores-companies-permissions-permission-id.md) - Company Roles and Permissions [List Company Roles](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/company-roles-and-permissions/get-stores-companies-roles.md) - Company Roles and Permissions [Create Company Role](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/company-roles-and-permissions/post-stores-companies-roles.md) - Company Roles and Permissions [Get Company Role Details](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/company-roles-and-permissions/get-stores-companies-roles-int-role-id.md) - Company Roles and Permissions [Update Company Role](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/company-roles-and-permissions/put-stores-companies-roles-role-id.md) - Company Roles and Permissions [Delete Company Role](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/company-roles-and-permissions/delete-stores-companies-roles-role-id.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/openapi.json) - [OpenAPI YAML](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/company/openapi.yaml)