---
title: customerRecover - Storefront API
description: |
  Sends a reset password email to the customer. The reset password
  email contains a reset password URL and token that you can pass to
  the [`customerResetByUrl`](https://shopify.dev/api/storefront/latest/mutations/customerResetByUrl) or
  [`customerReset`](https://shopify.dev/api/storefront/latest/mutations/customerReset) mutation to reset the
  customer password.

  This mutation is throttled by IP. With private access,
  you can provide a [`Shopify-Storefront-Buyer-IP`](https://shopify.dev/api/usage/authentication#optional-ip-header) instead of the request IP.
  The header is case-sensitive and must be sent as `Shopify-Storefront-Buyer-IP`.

  Make sure that the value provided to `Shopify-Storefront-Buyer-IP` is trusted. Unthrottled access to this
  mutation presents a security risk.
api_version: 2025-10
api_name: storefront
type: mutation
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/mutations/customerRecover
  md: https://shopify.dev/docs/api/storefront/latest/mutations/customerRecover.md
---

# customer​Recover

mutation

Requires `unauthenticated_write_customers` access scope.

Sends a reset password email to the customer. The reset password email contains a reset password URL and token that you can pass to the [`customerResetByUrl`](https://shopify.dev/api/storefront/latest/mutations/customerResetByUrl) or [`customerReset`](https://shopify.dev/api/storefront/latest/mutations/customerReset) mutation to reset the customer password.

This mutation is throttled by IP. With private access, you can provide a [`Shopify-Storefront-Buyer-IP`](https://shopify.dev/api/usage/authentication#optional-ip-header) instead of the request IP. The header is case-sensitive and must be sent as `Shopify-Storefront-Buyer-IP`.

Make sure that the value provided to `Shopify-Storefront-Buyer-IP` is trusted. Unthrottled access to this mutation presents a security risk.

## Arguments

* email

  [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  required

  The email address of the customer to recover.

***

## Customer​Recover​Payload returns

* customer​User​Errors

  [\[Customer​User​Error!\]!](https://shopify.dev/docs/api/storefront/latest/objects/CustomerUserError)

  non-null

  The list of errors that occurred from executing the mutation.

* user​Errors

  [\[User​Error!\]!](https://shopify.dev/docs/api/storefront/latest/objects/UserError)

  non-nullDeprecated

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### customerRecover reference

## Mutation Reference

```graphql
mutation customerRecover($email: String!) {
  customerRecover(email: $email) {
    customerUserErrors {
      # CustomerUserError fields
    }
  }
}
```

## Input

```json
{
  "email": "<your-email>"
}
```