---
title: HydrogenStorefrontCustomerUserError - GraphQL Admin
description: >-
  Catches validation errors when setting up customer authentication for your
  Hydrogen storefront, so you can quickly fix configuration issues and get
  customers logging in smoothly.


  For example, when setting invalid redirect URLs or JavaScript origins that
  don't meet security requirements, this error type captures the specific
  validation failure with clear guidance for resolution.


  Use `HydrogenStorefrontCustomerUserError` to:

  - Handle customer account configuration errors

  - Display specific validation messages for authentication setup

  - Identify problematic URL or origin configurations

  - Guide developers through Customer Account API requirements


  Each error includes the field that failed validation and a descriptive message
  explaining the specific requirement, making it easier to troubleshoot customer
  authentication setup.


  Learn more about [Customer Account API
  configuration](https://shopify.dev/docs/storefronts/headless/building-with-the-customer-account-api/getting-started).
api_version: unstable
api_name: admin
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/unstable/objects/HydrogenStorefrontCustomerUserError
  md: >-
    https://shopify.dev/docs/api/admin-graphql/unstable/objects/HydrogenStorefrontCustomerUserError.md
---

# Hydrogen​Storefront​Customer​User​Error

object

Requires Request must be initiated from the Shopify CLI and user must have full access to apps or access to the Hydrogen channel.

Catches validation errors when setting up customer authentication for your Hydrogen storefront, so you can quickly fix configuration issues and get customers logging in smoothly.

For example, when setting invalid redirect URLs or JavaScript origins that don't meet security requirements, this error type captures the specific validation failure with clear guidance for resolution.

Use `HydrogenStorefrontCustomerUserError` to:

* Handle customer account configuration errors
* Display specific validation messages for authentication setup
* Identify problematic URL or origin configurations
* Guide developers through Customer Account API requirements

Each error includes the field that failed validation and a descriptive message explaining the specific requirement, making it easier to troubleshoot customer authentication setup.

Learn more about [Customer Account API configuration](https://shopify.dev/docs/storefronts/headless/building-with-the-customer-account-api/getting-started).

## Fields

* code

  [Hydrogen​Storefront​Customer​User​Error​Code](https://shopify.dev/docs/api/admin-graphql/unstable/enums/HydrogenStorefrontCustomerUserErrorCode)

  The error code.

* field

  [\[String!\]](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String)

  The path to the input field that caused the error.

* message

  [String!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String)

  non-null

  The error message.

***

## Map

No referencing types

***

## Mutations

* [hydrogen​Storefront​Customer​Application​Urls​Replace](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/hydrogenStorefrontCustomerApplicationUrlsReplace)

  mutation

  Updates the customer account application URLs for a Hydrogen storefront, configuring the authentication and redirect endpoints used by Shopify's Customer Account API integration. This mutation validates URL formats and security requirements.

  For example, when setting up customer login functionality, developers configure the JavaScript origin for client-side authentication, logout redirect URIs for post-signout navigation, and the primary redirect URI for successful authentication flows.

  Use `hydrogenStorefrontCustomerApplicationUrlsReplace` to:

  * Configure customer authentication endpoints
  * Update redirect URLs for login and logout flows
  * Modify JavaScript origins for client-side integration
  * Validate URL security and format requirements

  The mutation replaces all existing URLs with the new configuration, ensuring consistent authentication behavior across the storefront. Detailed error reporting helps developers verify the configuration meets Shopify's security standards.

  Learn more about [Customer Account API integration](https://shopify.dev/docs/storefronts/headless/building-with-the-customer-account-api/getting-started).

***

## <\~> HydrogenStorefrontCustomerUserError Mutations

### Mutated by

* <\~>[hydrogen​Storefront​Customer​Application​Urls​Replace](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/hydrogenStorefrontCustomerApplicationUrlsReplace)

***

## Interfaces

* [Displayable​Error](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/DisplayableError)

  interface

***

## ||-HydrogenStorefrontCustomerUserError Implements

### Implements

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