---
title: CustomerResetByUrlPayload - Storefront API
description: Return type for `customerResetByUrl` mutation.
api_version: 2026-01
api_name: storefront
type: payload
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/payloads/customerresetbyurlpayload
  md: https://shopify.dev/docs/api/storefront/latest/payloads/customerresetbyurlpayload.md
---

# Customer​Reset​By​Url​Payload

payload

Return type for `customerResetByUrl` mutation.

## Fields

* customer

  [Customer](https://shopify.dev/docs/api/storefront/latest/objects/Customer)

  Token access required

  The customer object which was reset.

* customer​Access​Token

  [Customer​Access​Token](https://shopify.dev/docs/api/storefront/latest/objects/CustomerAccessToken)

  Token access required

  A newly created customer access token object for the customer.

* 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

***

## Mutations with this payload

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

  mutation

  Resets a customer's password using the reset URL from a password recovery email. The reset URL is generated by the [`customerRecover`](https://shopify.dev/docs/api/storefront/2026-01/mutations/customerRecover) mutation.

  On success, returns the updated [`Customer`](https://shopify.dev/docs/api/storefront/2026-01/objects/Customer) and a new [`CustomerAccessToken`](https://shopify.dev/docs/api/storefront/2026-01/objects/CustomerAccessToken) for immediate authentication.

  ***

  **Caution:** This mutation handles customer credentials. Ensure the new password is transmitted securely and never logged or exposed in client-side code.

  ***

  * reset​Url

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

    required

    ### Arguments

    The customer's reset password url.

  * password

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

    required

    New password that will be set as part of the reset password process.

  ***

***

## Map

### Mutations with this payload

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