---
title: "Save a new test password"
method: PUT
path: "/v1/addresses/{address}/password"
---

# Save a new test password

`PUT /v1/addresses/{address}/password`

## Request

- Base URL: `https://api.proxymail.qa`
- URL: `https://api.proxymail.qa/v1/addresses/{address}/password`
- Auth: HTTP bearer

Saves the password the test account uses now, replacing the one saved under the same label: after the app under test changed or reset it. Leave `password` out to generate a strong one (16 characters), returned once in this response. Any key can save one; reading it back needs "Can read saved passwords". Every save is logged. Only for test accounts' passwords, never a real person's.

## Path parameters

- `address` string, email, required

## Request body

- object
  - `password` string: Left out, one is generated.
  - `label` string: Which saved secret, such as password or pin.

## Response `200`

Saved

- object
  - `address` string
  - `label` string
  - `saved` boolean
  - `password` string: Only when it was generated, shown this once.

## Other responses

- `400`: An error
- `404`: An error

---

[API](https://skmtc.dev/proxymail/apis/proxy-mail-qa-api.md) · [All operations](https://skmtc.dev/proxymail/apis/proxy-mail-qa-api/llms.txt) · [OpenAPI document](https://skmtc.dev/proxymail/apis/proxy-mail-qa-api/revisions/8f8a5e84cf5c?raw)