hold_failed

Shopify refused the fulfillment hold

Code: hold_failed · HTTP status: usually 422

Shopify rejected holding the order’s fulfillment orders.

How to fix

Read the message for Shopify’s reason; check the order in the Shopify admin.

Example response

{
  "code": "hold_failed",
  "type": "https://docs.stoqapp.com/v2/docs/api-v2/errors/hold-failed/",
  "title": "Shopify refused the fulfillment hold",
  "status": 422,
  "detail": "Failed to hold fulfillments: fulfillment order is closed. Read the message for Shopify's reason; check the order in the Shopify admin.",
  "errors": [
    "Failed to hold fulfillments: fulfillment order is closed"
  ],
  "details": [
    {
      "code": "hold_failed",
      "message": "Failed to hold fulfillments: fulfillment order is closed",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}

Every API v2 and MCP failure carries code and a type link to its page here. See Errors & Responses for the full envelope.