---
title: "aid_customers_change_password"
method: POST
path: "/accounts/{aid}/customers/change_password"
tags: ["password"]
---

# aid_customers_change_password

`POST /accounts/{aid}/customers/change_password`

Specify the email address of the user whose password you
would like to reset. If the call is successful, the user
will receive an email prompting them to change their password.
The caller must have scope `write:accounts:/auth/users` to perform a
change password request.
scopes:
- write:accounts:/auth/users

## Path parameters

- `aid` string, ^[PT]{1}\d{8}$, required

## Request body

- object
  - `email` string, required
  - `audience` string, required — The unique identifier of the target API you want to access. The audience must be a grant associated with the client used when calling this resource.
  - `type` 'customer' | 'company', required — user type to login, required as users with different type can share email

## Response `204`

Success

## Other responses

- `400` — Bad / Invalid request
- `401` — Access forbidden, invalid JWT token was used
- `403` — Forbidden
- `500` — Unexpected Error

---

[API](https://skmtc.net/dintero/apis/account-management-api.md) · [All operations](https://skmtc.net/dintero/apis/account-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dintero/account-management-api/revisions/9b83a4199008/schema)