---
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/2026-10/mutations/customerResetByUrl)
  or [`customerReset`](/docs/api/storefront/2026-10/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: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/mutations/customerRecover'
  md: 'https://shopify.dev/docs/api/storefront/latest/mutations/customerRecover.md'
api_name: storefront
api_type: graphql
type: mutation
---

# 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/2026-10/mutations/customerResetByUrl) or [`customerReset`](https://shopify.dev/docs/api/storefront/2026-10/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>Shopify-Storefront-Buyer-IP\</code> 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