---
title: >-
  New return APIs to create exchanges, add fees, remove return lines and
  calculate returns - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/new-return-apis-to-create-exchanges-add-fees-remove-return-lines-and-calculate-returns
  md: >-
    https://shopify.dev/changelog/new-return-apis-to-create-exchanges-add-fees-remove-return-lines-and-calculate-returns.md
metadata:
  effectiveApiVersion: 2024-07
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2024-05-09T10:34:55-04:00'
  postedAt: '2024-07-01T09:49:00-04:00'
  updatedAt: '2024-05-23T09:53:46-04:00'
  effectiveAt: '2024-07-01T09:49:00-04:00'
---

July 1, 2024

Tags:

* Admin GraphQL API
* 2024-07

# New return APIs to create exchanges, add fees, remove return lines and calculate returns

As of 2024-07 in the GraphQL Admin API, you can use new return APIs to interact with exchange primitives.

The [`returnCreate`](https://shopify.dev/docs/api/admin-graphql/2024-07/mutations/returnCreate) mutation can now take exchange line items with optional discounts, return shipping fees and restocking fees to be applied to return lines. A return with exchange line items will also create a new FulfillmentOrder for the new items to be sent to the customer. Note that canceling a return does affect the fulfillment of exchange items. Read more on how exchanges are processed [here](https://help.shopify.com/en/manual/orders/refunds-returns/creating-returns#restock-and-fulfill).

The [`returnLineItemRemoveFromReturn`](https://shopify.dev/docs/api/admin-graphql/2024-07/mutations/returnLineItemRemoveFromReturn) mutation is now available to remove return lines from a return. With [returns creating sales](https://shopify.dev/changelog/return-mutation-will-update-sales-previously-unchanged-until-time-of-refund), removing a return line from a return will also reversely impact return sales.

The [`returnCalculate`](https://shopify.dev/docs/api/admin-graphql/2024-07/queries/returnCalculate) query is now available to calculate financials before return creation, including inputs for return lines, exchange lines, fees and discounts. Learn more about how to use this query in our [dev docs](https://shopify.dev/docs/apps/fulfillment/returns-apps/returns#step-2-optional-calculate-return-financials).