---
title: >-
  Notify customers when their return requests are approved or declined - 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/notify-customers-when-their-return-requests-are-approved-or-declined
  md: >-
    https://shopify.dev/changelog/notify-customers-when-their-return-requests-are-approved-or-declined.md
metadata:
  effectiveApiVersion: 2024-10
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2024-08-15T11:50:20-04:00'
  postedAt: '2024-10-01T09:00:00-04:00'
  updatedAt: '2024-08-16T11:20:35-04:00'
  effectiveAt: '2024-10-01T09:00:00-04:00'
---

October 1, 2024

Tags:

* Admin GraphQL API
* 2024-10

# Notify customers when their return requests are approved or declined

As of the 2024-10 API version, you can notify customers that their return request was approved or declined.

You can submit a `notifyCustomer` argument when approving a return request using [the `returnApproveRequest` mutation](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/returnApproveRequest).

You can also submit a `notifyCustomer` argument when declining a return request using [the `returnDeclineRequest` mutation](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/returnDeclineRequest). To include a custom message to the buyer in the email notification, use the `declineNote` argument.

When `notifyCustomer` is `true`, an email notification is sent to the [`Order.email`](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/Order#field-email). If this field is null, the notification is not sent.