> 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/users/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# Users

> **NOTE:**
> While Super Admins are B2B Edition user accounts, they are not included in the response data for this API. To manage Super Admin accounts, refer to the [B2B Edition Super Admin API](/developer/api-reference/rest/b2b/management/super-admin).

The Users API provides programmatic access to B2B Edition user management within BigCommerce. It enables storefront operations such as creating Company users, assigning roles, associating users with channels, and managing extra fields. This ensures that B2B customers can be onboarded, managed, and maintained according to your business logic and storefront requirements.

Each B2B Edition user account is associated with a BigCommerce customer account. To manage BigCommerce specific account information, refer to the [Customers API](/developer/api-reference/rest/admin/management/customers/v3).

### Limitations and Considerations

* **Role Management:** Only built-in roles (admin, senior buyer, junior buyer) are supported in filters, but custom roles are still accessible for reading and updating.
* **Bulk Operations:** Bulk user creation is limited to 10 users per request.
* **Deletion Safeguards:** Deleting the last user in a Company is not allowed; deleting all admin users is permitted but may render Companies unable to transact.
* **Channel Assignments:** Users must be assigned to at least one storefront channel in order to perform business operations in a store with multiple storefront channels.

> Build amazing commerce solutions powered by the BigCommerce platform


## API Docs

- Users [List B2B Users](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/users/companies-users-list.md)
- Users [Create Company User](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/users/companies-users-create.md)
- Users [Bulk Create Users](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/users/companies-users-bulk-create-create.md)
- Users [Get User Details](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/users/companies-user-by-id.md)
- Users [Update User Details](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/users/companies-user-update.md)
- Users [Delete User](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/users/companies-user-delete.md)
- Users [Get User Details by BigCommerce Customer ID](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/users/companies-user-read.md)
- Users [List Extra Fields for Users](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/users/get-users-extra-fields.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/users/openapi.json)
- [OpenAPI YAML](https://docs.bigcommerce.com/developer/api-reference/rest/b2b/management/users/openapi.yaml)