Skip to main content

categoryCreate

Create a new product category.

Creates a new category in the system with the provided information including multilingual content, SEO metadata, and hierarchical positioning. The category will be immediately available for product association and navigation.

Possible errors:

  • CREATE_CATEGORY_ERROR: Failed to create category due to validation or system errors
  • CATEGORY_NOT_FOUND_ERROR: Parent category does not exist (when parent is specified)
  • UNAUTHENTICATED: Invalid or missing authentication
  • FORBIDDEN: Insufficient permissions to create categories

AUTH: Role=[product.OWNER] OR ('user is authenticated')

categoryCreate(
  input: CreateCategoryInput!
): Category!

Arguments​

categoryCreate.input ● CreateCategoryInput! non-null input​

Category creation data.

Complete category information including names, descriptions, hierarchy, and SEO metadata. All required fields must be provided according to the input validation rules.

Type​

Category object​

Category entity representing product classification and organization.

External entity from the catalog service that provides category identification and hierarchy information. Used as a reference for category-specific attributes and organizational relationships within the attribute system.