Skip to main content

productAddPrices

Add Product Prices​

Creates multiple price tiers for a product that can be applied to customers or sales channels. This mutation enables tiered pricing strategies where different prices apply based on quantity thresholds.

Authentication​

Requires authentication and the products:add_price permission.

Pricing Strategy​

Each price in the structure defines a tier with a maximum quantity threshold. When max_units is omitted or zero, the price applies to unlimited quantities. Prices are automatically ordered by quantity thresholds to create consecutive pricing tiers.

Business Rules​

  • Product and priceable entity (customer/sales channel) must exist
  • Each max_units value must be unique within the same request
  • Cannot add max_units values that already exist for the same product and priceable combination
  • Unit prices must be positive values
  • Duplicate unit prices within the same request are not allowed
  • Processing happens asynchronously in the background

Possible Errors​

  • **Product not found**: The specified product doesn't exist
  • **Priceable entity not found**: The customer or sales channel doesn't exist
  • **Duplicate max_units**: Attempting to add quantity thresholds that already exist
  • **Invalid pricing data**: Negative prices, duplicate prices in request, or invalid quantity values
  • **Unauthorized**: User lacks the required permission
productAddPrices(
  input: AddProductPricesInput!
): AsynchronousActionResponse!

Arguments​

productAddPrices.input ● AddProductPricesInput! non-null input​

Parameters for AddProductPrices

Type​

AsynchronousActionResponse object​

Asynchronous action response type