Create a price list using the `priceListCreate` Admin GraphQL mutation, specifying the currency, a `fixedPricesAddOrUpdate` input with SKU-level fixed prices, or a `catalogAdjustment` for percentage off the original price.
Add quantity price breaks (tiered pricing) to specific variants on the price list using the `priceListFixedPricesAddOrUpdate` mutation, providing `compareAtPrice`, `price`, and a `quantityPriceBreaks` array — each break specifying a minimum quantity and the unit price at that quantity.
Set quantity rules on variants using the `quantityRulesAdd` Admin GraphQL mutation, specifying `minimumQuantity`, `maximumQuantity`, and `increment` per variant — these enforce minimum order quantities and pack sizes for B2B buyers.
Associate the price list with a company location catalog using the `catalogUpdate` mutation or by setting the price list on the B2B catalog that is assigned to the company location.
Verify the price list is active by checking out as a B2B buyer (via a customer associated with the company location) and confirming prices and quantity rules apply correctly.
Use the `priceList` Admin GraphQL query to audit configured prices and breaks; use the `quantityRules` query on a product variant to verify the rules are set.
Known gotchas
Quantity price breaks are only surfaced to buyers when they are authenticated as a B2B buyer associated with a company location that has the price list assigned. Anonymous or retail customers do not see B2B pricing — test with a properly configured B2B buyer account.
Quantity rules (minimum, maximum, increment) are enforced at checkout for B2B buyers but not surfaced automatically in the Storefront API product query without additional querying. Build explicit UI on the storefront product page to display these rules to buyers before they add to cart.
Price lists with `catalogAdjustment` (percentage off) are computed from the product's current compare-at price, not its original cost. If compare-at prices are inconsistently set on variants, the resulting B2B price may be unexpectedly high or low.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp