API Endpoint for Setting Order to ready_for_pickup

Technical Q&A

Topic summary

Multiple developers are encountering difficulties setting orders to “ready_for_pickup” status via API. The current POST endpoint for creating fulfillments (/admin/api/2020-04/orders/{order_id}/fulfillments/{fulfillment_id}.json) marks orders as fulfilled but doesn’t update them to ready_for_pickup status, despite metadata being stored on the fulfillment_order side.

Key Issue:

  • No documentation exists for updating pickup-ready status through the API
  • Standard fulfillment creation doesn’t trigger the ready_for_pickup state needed for in-store pickup workflows

Resolution:
A Shopify representative confirmed this is a known issue. A fix is scheduled for the 2023-01 API release, specifically through the fulfillmentOrderLineItemsPrepareForPickup GraphQL mutation (link provided in discussion).

Status: Issue acknowledged with planned resolution via upcoming API version.

Summarized with AI on November 25. AI used: claude-sonnet-4-5-20250929.
1

Hi,

I was wondering if anyone has come across the process flow or API endpoint for setting an order to ready_for_pickup?

When you create a new fulfillment at this endpoint via POST:

/admin/api/2020-04/orders/{order_id}/fulfillments/{fulfillment_id}json

with the following JSON:

{
“fulfillment”:{
“id”: 22222222222,
“location_id”:444444444,
“shipment_status”:“ready_for_pickup”,
“notify_customer”:true,
}
}

It creates a fulfillment marked as fulfilled but I need it to show as ready for pickup to the store. How can I set that order as Ready for Pickup using the API? I see that a lot of that metadata is stored at the fulfillment_order side but there is no documentation on how to update that status.

Thanks!

2

@trylokii

Any luck fixing this? I’m having the same issue.

Thanks

3

We have the same issue as well. Anyone from Shopífy who can clarify?

4

I’ve the same issue, anyone has a solution ?

5

This is a known issue and is slated to be resolved in the 2023-01 release candidate https://shopify.dev/api/admin-graphql/2023-01/mutations/fulfillmentOrderLineItemsPreparedForPickup