How to Generate a Password Reset Link Manually (Administrator)
When a user cannot receive the email (for example, mail is not connected on the instance), the reset link is created through the API and handed to the user directly. The link is one-time and valid for a limited time.
When It Will Be Useful
- The user has no access to their mailbox.
- Transactional mail is not connected on the instance and you need to help urgently.
What's Important to Know
- There is no button for this in the user card — the link is created by an API request.
- The link is one-time and has an expiration (depends on
PASSWORD_RESET_TOKEN_TTL, 24 hours by default). - For a client portal user the link leads to the portal, for everyone else — to the constructor.
- The user must have an email in the profile.
Before You Start
Step-by-Step Instructions
- Send
POST /auth/create-reset-pass-linkwith the body{ "login": "<user email>" }and your access token. - In the
201response takedata.resetLink. - Pass the link to the user through a convenient channel (chat, email, call).
- Explain that the link is one-time and valid for a limited time. Pass the link only to the account owner.
What Happens After
- The user opens the link, sets a new password and can sign in right away.
How to Verify Everything Worked
- The user confirms they signed in with the new password.
- No "This link has expired" or "This link has already been used" errors.
- If the API returned
403 forbidden_root_user, the user is root; only another root can create a link for them. - If the API returned
422 reset_link_base_missing,CONSTRUCTOR_ORIGIN(for the portal —CLIENT_PORTAL_URL) is not set on the instance.
Other Ways
- The user can use "Forgot password?" on the login page themselves if mail is connected on the instance.