---
title: >-
  Report Fulfillment Order progress with new fulfillmentOrderReportProgress
  GraphQL mutation - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/report-fulfillment-order-progress-with-new-fulfillmentorderreportprogress-graphql-mutation
  md: >-
    https://shopify.dev/changelog/report-fulfillment-order-progress-with-new-fulfillmentorderreportprogress-graphql-mutation.md
metadata:
  effectiveApiVersion: 2026-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
    - displayName: Webhook
      handle: webhook
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-01-28T06:14:19-05:00'
  postedAt: '2026-04-01T00:00:00-04:00'
  updatedAt: '2026-01-28T20:36:10-05:00'
  effectiveAt: '2026-04-01T00:00:00-04:00'
---

April 1, 2026

Tags:

* Admin GraphQL API
* Webhook
* 2026-04

# Report Fulfillment Order progress with new fulfillmentOrderReportProgress GraphQL mutation

As of API Version `2026-04` third-party logistics providers (3PLs) and fulfillment apps can now report progress on fulfillment orders with the [`fulfillmentOrderReportProgress` mutation](https://shopify.dev/docs/api/admin-graphql/latest/mutations/fulfillmentOrderReportProgress). 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 `IN_PROGRESS` status
* Reporting progress for merchant-managed orders works with fulfillment orders in `OPEN` or `IN_PROGRESS` status (requires `write_merchant_managed_fulfillment_orders` scope)
* Supports optional `reasonNotes` field (up to 256 characters) for additional context
* New `fulfillment_orders/progress_reported` webhook available to track when progress has been reported
* [fulfillmentOrder.supportedActions](https://shopify.dev/docs/api/admin-graphql/2026-01/objects/fulfillmentorder#field-supportedactions) field will now return the [REPORT\_PROGRESS](https://shopify.dev/docs/api/admin-graphql/2025-01/enums/FulfillmentOrderAction#enum-REPORT_PROGRESS) action when a fulfillment order can have progress reported.

#### New Webhooks

Topic: [`fulfillment_orders/progress_reported`](https://shopify.dev/docs/api/webhooks/2026-04?accordionItem=webhooks-fulfillment_orders-progress_reported\&reference=toml)

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`](https://shopify.dev/docs/api/webhooks/2026-04?accordionItem=webhooks-fulfillment_orders-manually_reported_progress_stopped\&reference=toml)

This webhook fires when a merchant-managed fulfillment order that has had progress manually reported (via `fulfillmentOrderReportProgress`) 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.