---
title: Password Forgot
slug: public-apis/password-forgot
createdAt: 2026-03-11T19:09:08.685Z
---

::::ExpandableHeading
###

**Topic type: Concept**

:::hint{type="warning"}
**Purpose:&#x20;**&#x50;assword Forgot event overview and guidance on when to send the event.&#x20;

**Audience:** Developers implementing password recovery or reset initiation flows.&#x20;

**Applies to:&#x20;**&#x41;ccount Protection integrations evaluating password reset initiation attempts.&#x20;

**Does not apply to:&#x20;**&#x50;assword changes for authenticated users or login attempts.
:::
::::

The `passwordForgot` call is intended to retrieve an Account Protection Score when a user clicks the Forgot Password link on your website. Use your Reset Password workflows after a `passwordForgot` event.

### Timing

The API call should come to the Interceptas Platform:

- After a user clicks the Forgot Password.
- After they pass error handling, and you retrieve their account details, IP Address, and User Agent.
- Before you send the result of their request.

### Flow

![Password Forgot flow diagram](https://api.archbee.com/api/optimize/C_ua77kdJRrVi_Gd-0NCF/WBgGSFwvEsNtsSDoqvLmC-20260318-154723.jpg "Password Forgot flow")

1. User navigates to your Forgot Password flow.
2. User enters in password retrieval option, like email address, username, or phone.
3. Client processes frontend validation to ensure all fields are filled in properly.
4. Client checks backend error handling (account doesn't exist).
5. Client retrieves account information, IP, and user agent.
6. Client's back-end server calls Accertify.
7. Accertify consolidates data and returns a score.
8. Client determines appropriate action for `passwordForgot`.



***

**See also**:

::::LinkArray{contentSource="CUSTOM"}
:::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/C_ua77kdJRrVi_Gd-0NCF/4VRPIgGNjk81XwCl3Q2ea-20260326-200545.png"}
[Password Forgot Fields](docId:35sRKjaeLSXzcA71y0_ur)
:::
::::

