---
title: "Create new password identity verification"
method: POST
path: "/api/experience/verification/new-password-identity"
tags: ["Experience"]
---

# Create new password identity verification

`POST /api/experience/verification/new-password-identity`

Create a NewPasswordIdentity verification record for the new user registration use. The verification record includes a unique user identifier and a password that can be used to create a new user account.

## Request body

- object
  - `identifier` object, required — The unique user identifier. <br/> Currently, only `username` is accepted. For `email` or `phone` registration, a `CodeVerification` record must be created and used to verify the user's email or phone number identifier.
    - `type` string, "username", required
    - `value` string, regex, required
  - `password` string, required — The new user password. (A password digest will be created and stored securely in the verification record.)

## Response `200`

The NewPasswordIdentity verification record has been successfully created.

- object
  - `verificationId` string, required — The unique verification ID of the newly created NewPasswordIdentity verification record. The `verificationId` is required when creating a new user account via the `Identification` API.

## Other responses

- `400` — Bad Request
- `422` — Unable to process the request. <br/>- `user.username_already_in_use:` The provided username is already in use. <br/>- `password.rejected:` The provided password is rejected by the password policy. Detailed password violation information is included in the response.

---

[API](https://skmtc.net/logto/apis/logto-api-references.md) · [All operations](https://skmtc.net/logto/apis/logto-api-references/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/logto/logto-api-references/revisions/0287c6a59eba/schema)