---
title: reverseDeliveryCreateWithShipping - GraphQL Admin
description: Creates a new reverse delivery with associated external shipping information.
api_version: 2025-10
api_name: admin
type: mutation
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/mutations/reverseDeliveryCreateWithShipping
  md: https://shopify.dev/docs/api/admin-graphql/latest/mutations/reverseDeliveryCreateWithShipping.md
---

# reverse​Delivery​Create​With​Shipping

mutation

Requires `write_returns` access scope or `write_marketplace_returns` access scope.

Creates a new reverse delivery with associated external shipping information.

## Arguments

* label​Input

  [Reverse​Delivery​Label​Input](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ReverseDeliveryLabelInput)

  Default:null

  The return label file information for the reverse delivery.

* notify​Customer

  [Boolean](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

  Default:true

  When `true` the customer is notified with delivery instructions if the `ReverseFulfillmentOrder.order.email` is present.

* reverse​Delivery​Line​Items

  [\[Reverse​Delivery​Line​Item​Input!\]!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ReverseDeliveryLineItemInput)

  required

  The reverse delivery line items to be created. If an empty array is provided, then this mutation will create a reverse delivery line item for each reverse fulfillment order line item, with its quantity equal to the reverse fulfillment order line item total quantity.

* reverse​Fulfillment​Order​Id

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

  required

  The ID of the reverse fulfillment order that's associated to the reverse delivery.

* tracking​Input

  [Reverse​Delivery​Tracking​Input](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ReverseDeliveryTrackingInput)

  Default:null

  The tracking information for the reverse delivery.

***

## Reverse​Delivery​Create​With​Shipping​Payload returns

* reverse​Delivery

  [Reverse​Delivery](https://shopify.dev/docs/api/admin-graphql/latest/objects/ReverseDelivery)

  The created reverse delivery.

* user​Errors

  [\[Return​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/ReturnUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### reverseDeliveryCreateWithShipping reference

## Mutation Reference

```graphql
mutation reverseDeliveryCreateWithShipping($reverseFulfillmentOrderId: ID!, $reverseDeliveryLineItems: [ReverseDeliveryLineItemInput!]!, $trackingInput: ReverseDeliveryTrackingInput, $labelInput: ReverseDeliveryLabelInput, $notifyCustomer: Boolean) {
  reverseDeliveryCreateWithShipping(reverseFulfillmentOrderId: $reverseFulfillmentOrderId, reverseDeliveryLineItems: $reverseDeliveryLineItems, trackingInput: $trackingInput, labelInput: $labelInput, notifyCustomer: $notifyCustomer) {
    reverseDelivery {
      # ReverseDelivery fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

```json
{
  "reverseFulfillmentOrderId": "gid://shopify/<objectName>/10079785100",
  "reverseDeliveryLineItems": [
    {
      "reverseFulfillmentOrderLineItemId": "gid://shopify/<objectName>/10079785100",
      "quantity": 1
    }
  ],
  "trackingInput": {
    "number": "<your-number>",
    "url": "https://example.myshopify.com"
  },
  "labelInput": {
    "fileUrl": "https://example.myshopify.com"
  },
  "notifyCustomer": true
}
```

##### Variables

```
{
  "reverseFulfillmentOrderId": "gid://shopify/<objectName>/10079785100",
  "reverseDeliveryLineItems": [
    {
      "reverseFulfillmentOrderLineItemId": "gid://shopify/<objectName>/10079785100",
      "quantity": 1
    }
  ],
  "trackingInput": {
    "number": "<your-number>",
    "url": "https://example.myshopify.com"
  },
  "labelInput": {
    "fileUrl": "https://example.myshopify.com"
  },
  "notifyCustomer": true
}
```

##### Schema

```
input ReverseDeliveryLineItemInput {
  reverseFulfillmentOrderLineItemId: ID!
  quantity: Int!
}

input ReverseDeliveryTrackingInput {
  number: String
  url: URL
}

input ReverseDeliveryLabelInput {
  fileUrl: URL!
}
```