---
title: CustomerUserError - Storefront API
description: Represents an error that happens during execution of a customer mutation.
api_version: 2025-10
api_name: storefront
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/objects/CustomerUserError
  md: https://shopify.dev/docs/api/storefront/latest/objects/CustomerUserError.md
---

# Customer​User​Error

object

Represents an error that happens during execution of a customer mutation.

## Fields

* code

  [Customer​Error​Code](https://shopify.dev/docs/api/storefront/latest/enums/CustomerErrorCode)

  The error code.

* field

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

  The path to the input field that caused the error.

* message

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

  non-null

  The error message.

***

## Map

No referencing types

***

## Mutations

* [customer​Access​Token​Create](https://shopify.dev/docs/api/storefront/latest/mutations/customerAccessTokenCreate)

  mutation

  Creates a customer access token. The customer access token is required to modify the customer object in any way.

* [customer​Access​Token​Create​With​Multipass](https://shopify.dev/docs/api/storefront/latest/mutations/customerAccessTokenCreateWithMultipass)

  mutation

  Creates a customer access token using a [multipass token](https://shopify.dev/api/multipass) instead of email and password. A customer record is created if the customer doesn't exist. If a customer record already exists but the record is disabled, then the customer record is enabled.

* [customer​Activate](https://shopify.dev/docs/api/storefront/latest/mutations/customerActivate)

  mutation

  Activates a customer.

* [customer​Activate​By​Url](https://shopify.dev/docs/api/storefront/latest/mutations/customerActivateByUrl)

  mutation

  Activates a customer with the activation url received from `customerCreate`.

* [customer​Address​Create](https://shopify.dev/docs/api/storefront/latest/mutations/customerAddressCreate)

  mutation

  Creates a new address for a customer.

* [customer​Address​Delete](https://shopify.dev/docs/api/storefront/latest/mutations/customerAddressDelete)

  mutation

  Permanently deletes the address of an existing customer.

* [customer​Address​Update](https://shopify.dev/docs/api/storefront/latest/mutations/customerAddressUpdate)

  mutation

  Updates the address of an existing customer.

* [customer​Create](https://shopify.dev/docs/api/storefront/latest/mutations/customerCreate)

  mutation

  Creates a new customer.

* [customer​Default​Address​Update](https://shopify.dev/docs/api/storefront/latest/mutations/customerDefaultAddressUpdate)

  mutation

  Updates the default address of an existing customer.

* [customer​Recover](https://shopify.dev/docs/api/storefront/latest/mutations/customerRecover)

  mutation

  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.

* [customer​Reset](https://shopify.dev/docs/api/storefront/latest/mutations/customerReset)

  mutation

  "Resets a customer’s password with the token received from a reset password email. You can send a reset password email with the [`customerRecover`](https://shopify.dev/api/storefront/latest/mutations/customerRecover) mutation."

* [customer​Reset​By​Url](https://shopify.dev/docs/api/storefront/latest/mutations/customerResetByUrl)

  mutation

  "Resets a customer’s password with the reset password URL received from a reset password email. You can send a reset password email with the [`customerRecover`](https://shopify.dev/api/storefront/latest/mutations/customerRecover) mutation."

* [customer​Update](https://shopify.dev/docs/api/storefront/latest/mutations/customerUpdate)

  mutation

  Updates an existing customer.

***

## <\~> CustomerUserError Mutations

### Mutated by

* <\~>[customer​Access​Token​Create](https://shopify.dev/docs/api/storefront/latest/mutations/customerAccessTokenCreate)
* <\~>[customer​Access​Token​Create​With​Multipass](https://shopify.dev/docs/api/storefront/latest/mutations/customerAccessTokenCreateWithMultipass)
* <\~>[customer​Activate](https://shopify.dev/docs/api/storefront/latest/mutations/customerActivate)
* <\~>[customer​Activate​By​Url](https://shopify.dev/docs/api/storefront/latest/mutations/customerActivateByUrl)
* <\~>[customer​Address​Create](https://shopify.dev/docs/api/storefront/latest/mutations/customerAddressCreate)
* <\~>[customer​Address​Delete](https://shopify.dev/docs/api/storefront/latest/mutations/customerAddressDelete)
* <\~>[customer​Address​Update](https://shopify.dev/docs/api/storefront/latest/mutations/customerAddressUpdate)
* <\~>[customer​Create](https://shopify.dev/docs/api/storefront/latest/mutations/customerCreate)
* <\~>[customer​Default​Address​Update](https://shopify.dev/docs/api/storefront/latest/mutations/customerDefaultAddressUpdate)
* <\~>[customer​Recover](https://shopify.dev/docs/api/storefront/latest/mutations/customerRecover)
* <\~>[customer​Reset](https://shopify.dev/docs/api/storefront/latest/mutations/customerReset)
* <\~>[customer​Reset​By​Url](https://shopify.dev/docs/api/storefront/latest/mutations/customerResetByUrl)
* <\~>[customer​Update](https://shopify.dev/docs/api/storefront/latest/mutations/customerUpdate)

***

## Interfaces

* [Displayable​Error](https://shopify.dev/docs/api/storefront/latest/interfaces/DisplayableError)

  interface

***

## ||-CustomerUserError Implements

### Implements

* ||-[Displayable​Error](https://shopify.dev/docs/api/storefront/latest/interfaces/DisplayableError)