---
title: "Send a password reset email to a user"
method: POST
path: "/users/{id}/reset-password"
tags: ["users"]
---

# Send a password reset email to a user

`POST /users/{id}/reset-password`

## Request

- Base URL: `https://api.smartrecruiters.com/user-api/v201804`
- URL: `https://api.smartrecruiters.com/user-api/v201804/users/{id}/reset-password`
- Auth: one of:
  - API key in header `x-smarttoken`
  - OAuth 2
    - Authorization code: `https://www.smartrecruiters.com/identity/oauth/allow`
    - Token URL: `https://api.smartrecruiters.com/identity/oauth/token` scopes: `users_manage`

Send password recovery instruction to the email address associated with a user with a given id. The password will not be reset until the user with a given id creates a new password.

## Response `204`

The password reset email successfully sent

## Other responses

- `400`: with codes * **USER_DISABLED** when user is disabled * **USER_LOCKED** when user is locked (after login/password failures) * **USER_EMAIL_INVALID** when user email is invalid
- `403`: with codes * **PASSWORD_AUTHENTICATION_DISABLED** when user cannot use login/password authentication
- `404`: User not found

---

[API](https://skmtc.dev/smartrecruiters/apis/users-api.md) - [All operations](https://skmtc.dev/smartrecruiters/apis/users-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartrecruiters/apis/users-api/revisions/22cf1eb7cae7?raw)