Update the password of a guest using OTP

This API helps you to update a guest's password by using the one-time password (OTP) that was sent to the guest's registered email ID after resetting the password.

To invoke this API, you must specify a unique identifier of the guest in the request as guest_id.

You must also provide in the request body the verification_code and verification_id details that the guest received after resetting the password. After the verification_code and verification_id details have been successfully validated, the guest's password is updated to the new_password value.

This API either returns a success parameter that indicates that the password-updation process was successful or returns an error object if there is any error.

Notes:

  1. You cannot invoke this API by using the tokens that are generated from the guest credentials.
  2. Only those employees who have a role that has permissions to edit a guest’s information, are allowed to access this API.
  3. The new_password value must meet Zenoti's password criteria.

Zenoti's Password Criteria
The password must contain a minimum of 8 characters.
The password must not contain the username details.
The password must contain at least 3 of the following 4 categories:

  1. Uppercase characters (A-Z)
  2. Lowercase characters (a-z)
  3. Base digits (0-9)
  4. Special characters ([~|!|@|#|$|%|^|&|*|+|=|||||(|)|{|}|[|]|;|:|'|"|<|>|,|.|-|_|/|?]/;)`

Request Body Details

NameTypeDescription
new_passwordstringNew password of the guest.
verification_codestringThe temporary code or one-time password (OTP) that is sent to the guest's registered email ID after resetting the password.
verification_idguidUnique 32-character verification identifier of the guest that is generated after resetting the password.

Response Details

NameTypeDescription
successboolIndicates whether the guest's password has been successfully updated.
errorobjectObject that contains error message and error code details. For more information, refer to the error Object table.

error Object

codemessage
400Bad Request.
401Unauthorized.
500Internal Server error.
404User Not Found.
Language
Authorization
Header
Click Try It! to start a request and see the response here!