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 defines a tier that unlocks at a quantity threshold. Despite the name, max_units is the smallest order quantity the price applies from, so a tier of 600 applies from 600 units upwards. When it is omitted or zero, the price is the base price for that customer or sales channel: it applies at any quantity and is used only when no tier's threshold is met.

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 common​

Parameters for AddProductPrices

Type​

AsynchronousActionResponse object common​

Asynchronous action response type