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

# Catalog - Category trees

> The Catalog API manages products, categories, brands, bulk pricing rules, and more. To learn more about catalog resources, see the [Catalog overview](/developer/docs/admin/catalog-and-inventory).

Our Catalog category trees and their [categories](/developer/api-reference/rest/admin/catalog/category-trees/categories) endpoints are the more modern and performant counterparts to the [categories (deprecated)](/developer/api-reference/rest/admin/catalog/categories) endpoints. Although the category trees endpoints and objects are designed to center an MSF-compatible, [multi-tenant category tree architecture](/developer/docs/admin/multi-storefront/api-guide#categories), the endpoints work just as well in a single storefront context and support batch requests. Use [catalog trees categories](/developer/api-reference/rest/admin/catalog/category-trees/categories) endpoints, instead of [categories (deprecated)](/developer/api-reference/rest/admin/catalog/categories) endpoints.

The category trees endpoints let you [get the categories for a specific tree](/developer/api-reference/rest/admin/catalog/category-trees/get-category-tree), and [bulk create](/developer/api-reference/rest/admin/catalog/category-trees/categories/create-categories), [bulk update](/developer/api-reference/rest/admin/catalog/category-trees/categories/update-categories), and [bulk delete](/developer/api-reference/rest/admin/catalog/category-trees/categories/delete-tree-categories) categories. You can also [bulk update the properties of category trees](/developer/api-reference/rest/admin/catalog/category-trees/upsert-category-trees), which includes changing the channels to which a tree is assigned.

The terms "category tree" and "catalog tree" are used interchangeably throughout the documentation.

> To learn more about authenticating Catalog endpoints, locate the **Authentication** section at the top of each endpoint, then click **Show Details**.

## Resources

### Webhooks

Learn more about [Category tree webhook events](/developer/docs/integrations/webhooks/event-reference/channel-events#category-trees).

### Additional Catalog endpoints

* [Brands](/developer/api-reference/rest/admin/catalog/brands)
* [Categories](/developer/api-reference/rest/admin/catalog/categories)
* [Products](/developer/api-reference/rest/admin/catalog/products)
* [Product modifiers](/developer/api-reference/rest/admin/catalog/product-modifiers)
* [Product variants](/developer/api-reference/rest/admin/catalog/product-variants)
* [Product variant options](/developer/api-reference/rest/admin/catalog/product-variant-options)

> Build amazing commerce solutions powered by the BigCommerce platform


## API Docs

- Admin Catalog: Category Trees [List Category Trees](https://docs.bigcommerce.com/developer/api-reference/rest/admin/catalog/category-trees/get-category-trees.md)
- Admin Catalog: Category Trees [Upsert Category Trees](https://docs.bigcommerce.com/developer/api-reference/rest/admin/catalog/category-trees/upsert-category-trees.md)
- Admin Catalog: Category Trees [Delete Category Trees](https://docs.bigcommerce.com/developer/api-reference/rest/admin/catalog/category-trees/delete-category-trees.md)
- Admin Catalog: Category Trees [Get Category Tree](https://docs.bigcommerce.com/developer/api-reference/rest/admin/catalog/category-trees/get-category-tree.md)
- Admin Catalog: Category Trees > Categories [List Categories](https://docs.bigcommerce.com/developer/api-reference/rest/admin/catalog/category-trees/categories/get-all-categories.md)
- Admin Catalog: Category Trees > Categories [Create Categories](https://docs.bigcommerce.com/developer/api-reference/rest/admin/catalog/category-trees/categories/create-categories.md)
- Admin Catalog: Category Trees > Categories [Update Categories](https://docs.bigcommerce.com/developer/api-reference/rest/admin/catalog/category-trees/categories/update-categories.md)
- Admin Catalog: Category Trees > Categories [Delete Categories](https://docs.bigcommerce.com/developer/api-reference/rest/admin/catalog/category-trees/categories/delete-tree-categories.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/admin/catalog/category-trees/openapi.json)
- [OpenAPI YAML](https://docs.bigcommerce.com/developer/api-reference/rest/admin/catalog/category-trees/openapi.yaml)