requestPasswordResetEmail mutation

The requestPasswordResetEmail mutation triggers the password reset email by the provided email address. Use it to initiate the process to reset the registered customer's password before calling the resetPassword mutation.

The mutation returns true if both of the following operations are successful:

Otherwise, the mutation returns false.

When the customer clicks the Set a New Password button, the application sends an email to the customer that contains a URL for resetting their password.

Reset password email

The URL has the following format:

https://<HOST>/customer/account/createPassword/?token=gh80pkjGdsPyiXc0sUUXswX1uGN7crUr

Use the value of the token in the resetPassword mutation.

Syntax

mutation: {requestPasswordResetEmail(email: String!): Boolean}

Reference

The requestPasswordResetEmail reference provides detailed information about the types and fields defined in this mutation.

Example usage

The following call triggers the password reset email.

Request:

mutation {
  requestPasswordResetEmail(
    email: "roni_cost@example.com"
  )
}

Response:

{
  "data": {
    "requestPasswordResetEmail": true
  }
}

Errors

Error
Description
Cannot reset the customer's password
A general error message that appears on some internal system errors. The original error is logged and can be found in the application logs.
The account is locked
You cannot modify a locked customer account.
The email address has an invalid format.
The value provided in the email argument has an invalid format.
You must specify an email address.
An empty value is provided in the email argument.

resetPassword mutation

data-slots=text

data-backgroundcolor=blue
Thanks to Atwix for contributing this topic!