---
title: customerRecover - Storefront API
description: >
  Sends a reset password email to the customer. The email contains a reset
  password URL and token that you can pass to the
  [`customerResetByUrl`](/docs/api/storefront/unstable/mutations/customerResetByUrl)
  or [`customerReset`](/docs/api/storefront/unstable/mutations/customerReset)
  mutation to reset the customer's password.


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


  > Caution:

  > Ensure the value provided to `Shopify-Storefront-Buyer-IP` is trusted.
  Unthrottled access to this mutation presents a security risk.
api_version: unstable
api_name: storefront
source_url:
  html: 'https://shopify.dev/docs/api/storefront/unstable/mutations/customerRecover'
  md: >-
    https://shopify.dev/docs/api/storefront/unstable/mutations/customerRecover.md
---

# customer​Recover

mutation

Requires `unauthenticated_write_customers` access scope.

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

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

***

**Caution:** Ensure the value provided to \<code>\<span class="PreventFireFoxApplyingGapToWBR">Shopify-Storefront-Buyer-I\<wbr/>P\</span>\</code> is trusted. Unthrottled access to this mutation presents a security risk.

***

## Arguments

* email

  [String!](https://shopify.dev/docs/api/storefront/unstable/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/unstable/objects/CustomerUserError)

  non-null

  The list of errors that occurred from executing the mutation.

* user​Errors

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

  non-nullDeprecated

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### customerRecover reference