---
title: fulfillmentOrderRejectFulfillmentRequest - GraphQL Admin
description: >-
  Rejects a fulfillment request sent to a fulfillment service for a fulfillment
  order.
api_version: 2024-10
api_name: admin
type: mutation
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/fulfillmentOrderRejectFulfillmentRequest
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/fulfillmentOrderRejectFulfillmentRequest.txt
---

# fulfillment​Order​Reject​Fulfillment​Request

mutation

Requires `write_assigned_fulfillment_orders` access scope. Also: The user must have fulfill\_and\_ship\_orders permission.

Rejects a fulfillment request sent to a fulfillment service for a fulfillment order.

## Arguments

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/ID)

  required

  The ID of the fulfillment order associated with the fulfillment request.

* line​Items

  [\[Incoming​Request​Line​Item​Input!\]](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/IncomingRequestLineItemInput)

  An optional array of line item rejection details. If none are provided, all line items will be assumed to be unfulfillable.

  **Note**: After the fulfillment request has been rejected, none of the line items will be able to be fulfilled. This field documents which line items specifically were unable to be fulfilled and why.

* message

  [String](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

  An optional reason for rejecting the fulfillment request.

* reason

  [Fulfillment​Order​Rejection​Reason](https://shopify.dev/docs/api/admin-graphql/2024-10/enums/FulfillmentOrderRejectionReason)

  The reason for the fulfillment order rejection.

***

## Fulfillment​Order​Reject​Fulfillment​Request​Payload returns

* fulfillment​Order

  [Fulfillment​Order](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/FulfillmentOrder)

  The fulfillment order whose fulfillment request was rejected.

* user​Errors

  [\[User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/UserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### Rejects a fulfillment request

  #### Description

  A fulfillment service rejects a fulfillment request for a fulfillment order.

  #### Query

  ```graphql
  mutation fulfillmentOrderRejectFulfillmentRequest($id: ID!, $message: String) {
    fulfillmentOrderRejectFulfillmentRequest(id: $id, message: $message) {
      fulfillmentOrder {
        id
        status
        requestStatus
      }
      userErrors {
        field
        message
      }
    }
  }
  ```

  #### Variables

  ```json
  {
    "id": "gid://shopify/FulfillmentOrder/1046000786",
    "message": "Can't fulfill due to no inventory on product"
  }
  ```

  #### cURL

  ```bash
  curl -X POST \
  https://your-development-store.myshopify.com/admin/api/2024-10/graphql.json \
  -H 'Content-Type: application/json' \
  -H 'X-Shopify-Access-Token: {access_token}' \
  -d '{
  "query": "mutation fulfillmentOrderRejectFulfillmentRequest($id: ID!, $message: String) { fulfillmentOrderRejectFulfillmentRequest(id: $id, message: $message) { fulfillmentOrder { id status requestStatus } userErrors { field message } } }",
   "variables": {
      "id": "gid://shopify/FulfillmentOrder/1046000786",
      "message": "Can'\''t fulfill due to no inventory on product"
    }
  }'
  ```

  #### Remix

  ```javascript
  const { admin } = await authenticate.admin(request);

  const response = await admin.graphql(
    `#graphql
    mutation fulfillmentOrderRejectFulfillmentRequest($id: ID!, $message: String) {
      fulfillmentOrderRejectFulfillmentRequest(id: $id, message: $message) {
        fulfillmentOrder {
          id
          status
          requestStatus
        }
        userErrors {
          field
          message
        }
      }
    }`,
    {
      variables: {
          "id": "gid://shopify/FulfillmentOrder/1046000786",
          "message": "Can't fulfill due to no inventory on product"
      },
    },
  );

  const data = await response.json();
  ```

  #### Ruby

  ```ruby
  session = ShopifyAPI::Auth::Session.new(
    shop: "your-development-store.myshopify.com",
    access_token: access_token
  )
  client = ShopifyAPI::Clients::Graphql::Admin.new(
    session: session
  )

  query = <<~QUERY
    mutation fulfillmentOrderRejectFulfillmentRequest($id: ID!, $message: String) {
      fulfillmentOrderRejectFulfillmentRequest(id: $id, message: $message) {
        fulfillmentOrder {
          id
          status
          requestStatus
        }
        userErrors {
          field
          message
        }
      }
    }
  QUERY

  variables = {
    "id": "gid://shopify/FulfillmentOrder/1046000786",
    "message": "Can't fulfill due to no inventory on product"
  }

  response = client.query(query: query, variables: variables)
  ```

  #### Node.js

  ```javascript
  const client = new shopify.clients.Graphql({session});
  const data = await client.query({
    data: {
      "query": `mutation fulfillmentOrderRejectFulfillmentRequest($id: ID!, $message: String) {
        fulfillmentOrderRejectFulfillmentRequest(id: $id, message: $message) {
          fulfillmentOrder {
            id
            status
            requestStatus
          }
          userErrors {
            field
            message
          }
        }
      }`,
      "variables": {
          "id": "gid://shopify/FulfillmentOrder/1046000786",
          "message": "Can't fulfill due to no inventory on product"
      },
    },
  });
  ```

  #### Response

  ```json
  {
    "fulfillmentOrderRejectFulfillmentRequest": {
      "fulfillmentOrder": {
        "id": "gid://shopify/FulfillmentOrder/1046000786",
        "status": "OPEN",
        "requestStatus": "REJECTED"
      },
      "userErrors": []
    }
  }
  ```

* ### fulfillmentOrderRejectFulfillmentRequest reference

[Open in GraphiQL](http://localhost:3457/graphiql?query=mutation%20fulfillmentOrderRejectFulfillmentRequest\(%24id%3A%20ID!%2C%20%24message%3A%20String\)%20%7B%0A%20%20fulfillmentOrderRejectFulfillmentRequest\(id%3A%20%24id%2C%20message%3A%20%24message\)%20%7B%0A%20%20%20%20fulfillmentOrder%20%7B%0A%20%20%20%20%20%20id%0A%20%20%20%20%20%20status%0A%20%20%20%20%20%20requestStatus%0A%20%20%20%20%7D%0A%20%20%20%20userErrors%20%7B%0A%20%20%20%20%20%20field%0A%20%20%20%20%20%20message%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D\&variables=%7B%0A%20%20%22id%22%3A%20%22gid%3A%2F%2Fshopify%2FFulfillmentOrder%2F1046000786%22%2C%0A%20%20%22message%22%3A%20%22Can't%20fulfill%20due%20to%20no%20inventory%20on%20product%22%0A%7D)

```javascript
const { admin } = await authenticate.admin(request);


const response = await admin.graphql(
  `#graphql
  mutation fulfillmentOrderRejectFulfillmentRequest($id: ID!, $message: String) {
    fulfillmentOrderRejectFulfillmentRequest(id: $id, message: $message) {
      fulfillmentOrder {
        id
        status
        requestStatus
      }
      userErrors {
        field
        message
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/FulfillmentOrder/1046000786",
        "message": "Can't fulfill due to no inventory on product"
    },
  },
);


const data = await response.json();
```

## Input variables

JSON

```json
{
  "id": "gid://shopify/FulfillmentOrder/1046000786",
  "message": "Can't fulfill due to no inventory on product"
}
```

## Response

JSON

```json
{
  "fulfillmentOrderRejectFulfillmentRequest": {
    "fulfillmentOrder": {
      "id": "gid://shopify/FulfillmentOrder/1046000786",
      "status": "OPEN",
      "requestStatus": "REJECTED"
    },
    "userErrors": []
  }
}
```