--- title: ReturnUserError - GraphQL Admin description: An error that occurs during the execution of a return mutation. api_version: 2025-10 api_name: admin type: object api_type: graphql source_url: html: https://shopify.dev/docs/api/admin-graphql/latest/objects/returnusererror md: https://shopify.dev/docs/api/admin-graphql/latest/objects/returnusererror.md --- # Return​User​Error object An error that occurs during the execution of a return mutation. ## Fields * code [Return​Error​Code](https://shopify.dev/docs/api/admin-graphql/latest/enums/ReturnErrorCode) The error code. * field [\[String!\]](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) The path to the input field that caused the error. * message [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The error message. *** ## Map No referencing types *** ## Mutations * [remove​From​Return](https://shopify.dev/docs/api/admin-graphql/latest/mutations/removeFromReturn) mutation Removes return and/or exchange lines from a return. * [return​Approve​Request](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnApproveRequest) mutation Approves a customer's return request. If this mutation is successful, then the `Return.status` field of the approved return is set to `OPEN`. * [return​Cancel](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnCancel) mutation Cancels a return and restores the items back to being fulfilled. Canceling a return is only available before any work has been done on the return (such as an inspection or refund). * [return​Close](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnClose) mutation Indicates a return is complete, either when a refund has been made and items restocked, or simply when it has been marked as returned in the system. * [return​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnCreate) mutation Creates a return from an existing order that has at least one fulfilled [line item](https://shopify.dev/docs/api/admin-graphql/latest/objects/LineItem) that hasn't yet been refunded. If you create a return on an archived order, then the order is automatically unarchived. Use the `returnCreate` mutation when your workflow involves [approving](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnApproveRequest) or [declining](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnDeclineRequest) requested returns outside of the Shopify platform. The `returnCreate` mutation performs the following actions: * Creates a return in the `OPEN` state, and assumes that the return request from the customer has already been approved * Creates a [reverse fulfillment order](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/manage-reverse-fulfillment-orders), and enables you to create a [reverse delivery](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/manage-reverse-deliveries) for the reverse fulfillment order * Creates a sales agreement with a `RETURN` reason, which links to all sales created for the return or exchange * Generates sales records that reverse the sales records for the items being returned * Generates sales records for any exchange line items After you've created a return, use the [`return`](https://shopify.dev/docs/api/admin-graphql/latest/queries/return) query to retrieve the return by its ID. Learn more about providing a [return management workflow](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/build-return-management) for merchants. * [return​Decline​Request](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnDeclineRequest) mutation Declines a return on an order. When a return is declined, each `ReturnLineItem.fulfillmentLineItem` can be associated to a new return. Use the `ReturnCreate` or `ReturnRequest` mutation to initiate a new return. * [return​Process](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnProcess) mutation Process a return. * [return​Reopen](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnReopen) mutation Reopens a closed return. * [return​Request](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnRequest) mutation A customer's return request that hasn't been approved or declined. This mutation sets the value of the `Return.status` field to `REQUESTED`. To create a return that has the `Return.status` field set to `OPEN`, use the `returnCreate` mutation. * [reverse​Delivery​Create​With​Shipping](https://shopify.dev/docs/api/admin-graphql/latest/mutations/reverseDeliveryCreateWithShipping) mutation Creates a new reverse delivery with associated external shipping information. * [reverse​Delivery​Shipping​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/reverseDeliveryShippingUpdate) mutation Updates a reverse delivery with associated external shipping information. * [reverse​Fulfillment​Order​Dispose](https://shopify.dev/docs/api/admin-graphql/latest/mutations/reverseFulfillmentOrderDispose) mutation Disposes reverse fulfillment order line items. ### Deprecated mutations * [return​Line​Item​Remove​From​Return](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnLineItemRemoveFromReturn) mutation Deprecated * [return​Refund](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnRefund) mutation Deprecated *** ## <\~> ReturnUserError Mutations ### Mutated by * <\~>[remove​From​Return](https://shopify.dev/docs/api/admin-graphql/latest/mutations/removeFromReturn) * <\~>[return​Approve​Request](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnApproveRequest) * <\~>[return​Cancel](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnCancel) * <\~>[return​Close](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnClose) * <\~>[return​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnCreate) * <\~>[return​Decline​Request](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnDeclineRequest) * <\~>[return​Process](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnProcess) * <\~>[return​Reopen](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnReopen) * <\~>[return​Request](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnRequest) * <\~>[reverse​Delivery​Create​With​Shipping](https://shopify.dev/docs/api/admin-graphql/latest/mutations/reverseDeliveryCreateWithShipping) * <\~>[reverse​Delivery​Shipping​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/reverseDeliveryShippingUpdate) * <\~>[reverse​Fulfillment​Order​Dispose](https://shopify.dev/docs/api/admin-graphql/latest/mutations/reverseFulfillmentOrderDispose) *** ## Interfaces * [Displayable​Error](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/DisplayableError) interface *** ## ||-ReturnUserError Implements ### Implements * ||-[Displayable​Error](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/DisplayableError)