ReturnCreate NotifyCustomer Issues

GraphQL Admin API Troubleshooting
1

Hi everyone,

We’ve been using the returnCreate mutation in the Admin GraphQL API to create returns on Shopify, including gift returns. Recently, we’ve noticed an increase in cases where the gifter becomes aware that a return has been made.

I understand there’s no way to completely prevent gifters from checking their order status page and seeing that a return exists. However, it would be great if we could at least avoid proactively notifying them.

I saw that the notifyCustomer parameter on returnCreate has been deprecated, but gifters still receive a notification through the Shop app that a “Return request has been approved.”

Could someone clarify why notifyCustomer was deprecated? And is the expectation that we should migrate to returnApproveRequest, since that mutation still includes a notifyCustomer parameter?

Thanks!

2

hi, bumping this thread!

3

cc: @KyleG-Shopify @Alan_G

5

Hey @Rohan-Frate - thanks for your patience on this! notifyCustomer was deprecated on returnCreate since that mutation is designed for creating already-approved returns, if that makes sense..
Right now, recommended workflow is to use the returnRequest mutation to create a return in the REQUESTED state. Then, like you said, you’d use the returnApproveRequest mutation to approve it and move the return to an OPEN state (this still accepts notifyCustomer)

You can still control notifications during the approval step using returnApproveRequest(notifyCustomer: false), which should give you the same flexibility for those gift return scenarios. Hope this helps/makes sense - let me know if I can clarify anything here.