Reset password and send email

Reset Password and Send Email

This endpoint initiates a password reset for a specific user profile. The system generates a new secure password, updates the user's account immediately, and sends a notification email to the registered email address with login instructions. This allows partners to programmatically trigger secure password recovery for their customers.

Endpoint

POST /netevia/resetPassword/{profileId}

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint when a customer has lost access to their account and needs their password reset. It is appropriate for partner-initiated resets triggered by a support request or a self-service flow. The endpoint handles both the credential update and the email notification in a single call, ensuring the user is informed of the change immediately.

Path Parameters

Response

200 OK

The password has been successfully reset and a notification email has been sent to the registered email address associated with the profile.

{}

Error Codes

Common Mistakes

• Providing a profileId that does not exist will result in a 404 error; confirm the profile ID before calling this endpoint.
• Using an expired or missing Bearer token will result in a 401 error; ensure the token is refreshed before making the request.
• Calling this endpoint for a profile whose registered email address is not verified may result in the notification email not being delivered.

Related Endpoints

• POST /api/auth/v2 — Obtain a Bearer token for authentication
• POST /api/auth/refresh — Refresh an existing Bearer token
• POST /netevia/createProfile — Create a new user profile

Example

curl -X POST https://api.banking.netevia.dev/netevia/resetPassword/1042 \
  -H "Authorization: Bearer YOUR_TOKEN"