---
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
---

[Back to Developer changelog](https://shopify.dev/changelog)

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).