# FulfillmentOrderHoldInput - admin - INPUT_OBJECT Version: 2025-01 ## Description The input fields for the fulfillment hold applied on the fulfillment order. ### Access Scopes ## Fields * [externalId](/docs/api/admin/2025-01/scalars/String): String - A configurable ID used to track the automation system releasing these holds. * [fulfillmentOrderLineItems](/docs/api/admin/2025-01/input-objects/FulfillmentOrderLineItemInput): FulfillmentOrderLineItemInput - The fulfillment order line items to be placed on hold. If left blank, all line items of the fulfillment order are placed on hold. Not supported when placing a hold on a fulfillment order that is already held. If supplied when a fulfillment order is already on hold, [a user error](https://shopify.dev/api/admin-graphql/latest/enums/FulfillmentOrderHoldUserErrorCode#value-fulfillmentordernotsplittable) will be returned indicating that the fulfillment order is not able to be split. * [handle](/docs/api/admin/2025-01/scalars/String): String - An identifier that an app can use to reference one of the holds that it applies to a fulfillment order. This field must be unique among the holds that a single app applies to a single fulfillment order. It prevents apps from inadvertently creating duplicate holds. This field cannot exceed 64 characters. For example, an app can place multiple holds on a single fulfillment order each with a different `handle`. If an app attempts to place two holds with the same `handle`, the second hold will be rejected with [a duplicate hold user error](https://shopify.dev/api/admin-graphql/latest/enums/FulfillmentOrderHoldUserErrorCode#value-duplicatefulfillmentholdhandle). The same `handle` can however be re-used on different fulfillment orders and by different apps. By default, `handle` will be an empty string. If an app wishes to place multiple holds on a single fulfillment order, then a different `handle` must be provided for each. * [notifyMerchant](/docs/api/admin/2025-01/scalars/Boolean): Boolean - Whether the merchant receives a notification about the fulfillment hold. The default value is `false`. * [reason](/docs/api/admin/2025-01/enums/FulfillmentHoldReason): FulfillmentHoldReason! - The reason for the fulfillment hold. * [reasonNotes](/docs/api/admin/2025-01/scalars/String): String - Additional information about the fulfillment hold reason. ## Input objects with this input object * [fulfillmentOrderHold](/docs/api/admin/2025-01/mutations/fulfillmentOrderHold) ## Examples