Build a Shopify Bulk Operations GraphQL mutation to bulk-update variant prices from an external pricing engine

domain: Shopify Admin GraphQL Bulk Operations · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Stage a JSONL file where each line is a productVariantsBulkUpdate input object containing the variant ID and new price, uploadable via the stagedUploadsCreate mutation
  2. Upload the JSONL file to the staged upload URL using a multipart PUT request, then pass the staged upload URL to the bulkOperationRunMutation mutation
  3. Poll the bulkOperation query for status until it reaches COMPLETED, handling FAILED states by inspching the errorCode and partialDataUrl
  4. Download the partial or full results JSONL from the objectUrl returned on completion and parse mutation outcomes for each variant
  5. Flag variants where the mutation returned userErrors (e.g., price below cost or currency mismatch) and queue them for manual review
  6. After the bulk operation completes, invalidate any CDN-cached product pages or price list cache entries that reference affected variants

Known gotchas

Related routes

Run a Shopify Admin GraphQL bulk mutation to update variant prices across a large catalog using stagedUploadsCreate and bulkOperationRunMutation
shopify.dev · 6 steps · unrated
Run a Shopify Admin GraphQL bulk mutation to update metafield values across thousands of products using stagedUploadsCreate and bulkOperationRunMutation
shopify.dev · 6 steps · unrated
Run a Shopify Admin GraphQL stagedUploadsCreate + bulkOperationRunMutation pipeline to bulk-import metafield values for thousands of products
shopify.dev · 5 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans