Migrate API 2022-04 to 2022-07 - Fulfillment

Topic summary

Main issue: After migrating from API version 2022-04 to 2022-07, the REST endpoint /orders/{order_id}/fulfillments.json is no longer available, leaving uncertainty on how to create a fulfillment for a single order.

Key update: In 2022-07, Shopify creates a FulfillmentOrder (status: open) automatically when an order is created. Instead of fulfilling directly on the Order, you must:

  • Find the FulfillmentOrder ID associated with the target order.
  • Create the fulfillment by calling the Fulfillment POST endpoint (shopify.dev/admin REST 2022-07 Fulfillment: POST /fulfillments), using that FulfillmentOrder reference.

Context terms:

  • FulfillmentOrder: Represents fulfillable items for an order and is created automatically by Shopify.
  • Fulfillment: The actual record/action of fulfilling items, created via the POST endpoint referencing the FulfillmentOrder.

Outcome: A community member provided this workflow and documentation link; the original poster acknowledged the solution with thanks. Status: Resolved with a clear migration path.

Summarized with AI on February 6. AI used: gpt-5.

@lmathieu This is so annoying when Shopify changes their API but doesn’t provide any clear documentation for this. There is a guy who found a solution to this problem, you can check the solution detail here. Basically, whenever an order has been created in the store, shopify will automatically create a fulfillment order with status open.

Therefore, you have to find the fulfillment order id of your order, then you can call this endpoint to fulfilled your order

1 Like