---
title: Password Update
slug: public-apis/password-update
createdAt: 2026-03-11T19:09:23.404Z
---

::::ExpandableHeading
###

**Topic type: Concept**

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

**Audience:** Developers implementing password change functionality.&#x20;

**Applies to:&#x20;**&#x41;ccount Protection integrations evaluating password updates for existing accounts.&#x20;

**Does not apply to:&#x20;**&#x50;assword recovery initiation or account creation.
:::
::::

The `passwordUpdate` call is intended to retrieve an Account Protection Score when a user updates their password following a password reset on your website.

### Timing

The API call should come to the Interceptas Platform:

- After a user attempts to reset their 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.

:::hint{type="info"}
<font color="#386B84">**Note**</font>: This call is not meant to occur after a user changes their password while authenticated. Use the `accountUpdate` call for that instance.
:::

### Flow

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

1. User gets an email to reset their password and lands on the reset password page.
2. User enters their new password.
3. Client processes frontend validation to ensure all fields are filled in properly.
4. Client retrieves account information, IP, and user agent.
5. Client's backend server calls Accertify.
6. Accertify consolidates data and returns a score.
7. Client determines appropriate action for `passwordUpdate`.



***

**See also**:

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

