Report Fulfillment Order progress with new fulfillmentOrderReportProgress GraphQL mutation
Shopify's 2026-04 API introduces fulfillmentOrderReportProgress mutation, letting 3PLs and fulfillment apps push real-time status updates into merchant order pipelines. Two new webhooks track progress events and cancellations for merchant-managed orders.
If you run a Shopify-connected 3PL or fulfillment app feeding into marketplace brands, you can now surface mid-fulfillment status without custom workarounds — reducing 'where's my order' merchant support tickets. Agencies managing multi-channel brands should audit their fulfillment app integrations to see if vendors plan to adopt this API before Q3 2026.
Platform consolidation play: Shopify tightens its grip on post-purchase fulfillment data, reducing reliance on third-party tracking tools and making native Shopify more competitive against Amazon's end-to-end logistics transparency.
Check your 3PL or fulfillment app's Shopify integration roadmap -- if they don't adopt fulfillmentOrderReportProgress by mid-2026, your merchant clients lose visibility during IN_PROGRESS order stages.
Set up the fulfillment_orders/progress_reported webhook in your Shopify app within 30 days to capture attribution data and reason_notes fields before merchant SLA disputes arise.
Bottom Line
Shopify 3PL apps now push live order status to merchants natively.
Source Lens
Technical Platform Update
Official but usually technical. Useful only when the change affects merchant-facing operations.
Impact Level
medium
Shopify 3PL apps now push live order status to merchants natively.
Key Stat / Trigger
256-character reason_notes field for fulfillment status updates
Focus on the operational implication, not just the headline.
Full Coverage
Back to Developer changelog April 1, 2026 Tags: Admin GraphQL API Webhook 2026-04 Report Fulfillment Order progress with new fulfillmentOrderReportProgress GraphQL mutation Ask assistant As of API Version 2026-04 third-party logistics providers (3PLs) and fulfillment apps can now report progress on fulfillment orders with the fulfillment Order Report Progress mutation.
This feature enables fulfillment services to indicate that work has commenced and, optionally, add brief status notes so merchants see what’s happening in their fulfilment pipeline.
Key Details: Reporting progress for 3PL-managed orders works with fulfillment orders in I N _P R O G R E S S status Reporting progress for merchant-managed orders works with fulfillment orders in O P E N or I N _P R O G R E S S status (requires write _merchant _managed _fulfillment _orders scope) Supports optional reason Notes field (up to 256 characters) for additional context New fulfillment _orders /progress _reported webhook available to track when progress has been reported fulfillmentOrder.
supportedActions field will now return the REPORT_PROGRESS action when a fulfillment order can have progress reported. New Webhooks Topic: fulfillment _orders /progress _reported This webhook is triggered when progress is reported on a fulfillment order.
The payload includes the fulfillment order ID and status, the initial _status before the update, and progress _report details including reason _notes and attribution data for the app or user that reported the progress.
Topic: fulfillment _orders /manually _reported _progress _stopped This webhook fires when a merchant-managed fulfillment order that has had progress manually reported (via fulfillment Order Report Progress ) is subsequently marked as "ready for fulfillment", transitioning it from IN_PROGRESS back to OPEN status.
This webhook allows apps to know when a merchant has "undone" or "cancelled" the in-progress status they previously reported. Was this section helpful? Yes No
Original Source
This briefing is based on reporting from Shopify Developer Changelog. Use the original post for full primary-source context.
Style
Audience