Forgot Password

If the viewer doesn’t remember the password, he/she can reset it.

Data required for password reset:

  • customer email and
  • offerId or publisherId (to identify the customer with the publisher).

This feature can also be used to reset the password in My Account -> User Profile Management .

Default Reset Password Page

If you use a default reset password page, the password reset process is as follows:

  1. Make a request to /customers/passwords.
  2. An email with a reset password link will be sent to the given email.
  3. By following the link, the viewer will be able to reset to a new password.

Please note that by default, the link will redirect the customer to the default reset password page.

Default reset password form

Reset password flowchart

Custom Reset Password Page

If you use a custom password page, the password reset process is as follows:

  1. Make a request to /customers/passwords with resetUrl param.
  2. An email with a reset password link will be sent to the given email.
  3. By following the link, the viewer will be redirected to a given resetUrl where he/she should be able to provide a new password (resetPasswordToken will be added to resetUrl as a query param).
  4. Update customer password by using /customers/passwords endpoint.

Captcha

📘

Good to know

We recommend using Captcha mechanisms to prevent getting rate limits.

Rate limits are:

  • by default, each method has 200 rps and 50 concurrent requests,
  • login method has 50 rps and 20 concurrent requests,
  • registration method has 20 rps and 10 concurrent requests,
  • reset password method has 10 rps and 5 concurrent requests (because it sends an email).

When reaching the limit, you will get 429 error code. If that happens, wait a few moments to unlock this endpoint.

Updated about a month ago


Forgot Password


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.