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
        • Brands
        • Categories
        • Category Trees
            • GETList Category Trees
            • PUTUpsert Category Trees
            • DELDelete Category Trees
            • GETGet Category Tree
        • Products
        • Product Modifiers
        • Product Variants
        • Product Variant Options
      • Payments
  • GraphQL
    • Overview
  • MCP
    • Overview
Dev Portal
LogoLogo
On this page
  • Resources
  • Webhooks
  • Additional Catalog endpoints
RESTAdminCatalog

Catalog - Category trees

Was this page helpful?
Previous

Update Product Sort Order

Next

List Category Trees

Built with

The Catalog API manages products, categories, brands, bulk pricing rules, and more. To learn more about catalog resources, see the Catalog overview.

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

The category trees endpoints let you get the categories for a specific tree, and bulk create, bulk update, and bulk delete categories. You can also bulk update the properties of 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.

Additional Catalog endpoints

  • Brands
  • Categories
  • Products
  • Product modifiers
  • Product variants
  • Product variant options