Skip to content

Complete password reset


Target audience: Developers

Release version: 4.1.3

Complete password reset


This endpoint is used to complete the password reset flow. It will trigger the "account_password_reset_complete" event.


Environment URI


Identity Scope
No /external/account/w


Field Required Type Description
id Reguired String The id of the account.
Size range: ..24
Allowed values: "/^[a-f\d]{24}$/i"
confirmation_code Required String The confirmation code for the account.
Size: 36
new_password Required String The new password.
Size range: 6..1024

Curl Example

curl --request POST \
  --url \
  --header 'accept: application/json' \
  --header 'authorization: Bearer token' \
  --header 'content-type: application/json' \
  --data '{
            "id": "50f3ac249f6aef294d000007",
            "confirmation_code": "fd49ed16-d6ef-4271-a8e8-278215ab79bd",
            "new_password": "new_password159!"


Field Description
id id of the updated account

Example Response

HTTP 200 Updated
    "id": "50f3ac249f6aef294d000007"


Example error response

HTTP 400 Bad Request
    "code": "invalid_parameter",
    "field": "id",
    "message": "Parameter must match format (/^[a-f\d]{24}$/)"

HTTP 400 Bad Request

Name Type Description
invalid_parameter Object Validation error on any of the fields in the posted json
json_parser_error Object The request body could not be parsed as valid json
invalid_content_type_error Object The requests Content-Type header isn't set to application/json
unknown_parameter Object One or more of the fields in the posted json was not recognized

HTTP 404 Not Found

Name Type Description
not_found Object The package could not be found

HTTP 500 Internal Server Error

Name Type Description
internal_server_error Object Something unexpected happened server side