Create a price list using the priceListCreate GraphQL mutation; supply a name, currency, and a parent.adjustment object specifying type (PERCENTAGE_INCREASE or PERCENTAGE_DECREASE) and value (a positive float representing the percentage magnitude).
Associate the price list with a B2B catalog by linking it to a CompanyLocation via the catalog configuration; the price list drives pricing for all buyers assigned to that catalog.
Add variant-level fixed prices using the priceListFixedPricesAdd mutation; pass an array of up to 250 PriceListFixedPriceInput objects, each with a variantId and price (amount + currencyCode).
Understand the override hierarchy: if a variant has a fixed price set on the price list, that fixed price is used; if no fixed price exists, the variant's compare-at or base price is adjusted by the parent percentage adjustment.
Update or remove fixed prices with priceListFixedPricesUpdate and priceListFixedPricesDelete; update the percentage adjustment with priceListUpdate targeting the parent.adjustment fields.
Query price list details and per-variant prices using the priceList query with the prices connection to verify effective prices before publishing the catalog to buyers.
Known gotchas
PriceListAdjustmentType has exactly two valid enum values: PERCENTAGE_DECREASE (prices lower than base) and PERCENTAGE_INCREASE (prices higher than base); the value field is always a positive number regardless of direction.
Fixed prices on a variant completely override the percentage adjustment for that variant — there is no blended calculation; ensure fixed prices are intentional and not accidental overrides.
priceListFixedPricesAdd acts as an upsert: if a fixed price already exists for a given variant, it is replaced silently; run the prices query after bulk operations to confirm the final state.
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