On password reset requested

You can use this event to email a secure reset link to users who request it, keep track of how often resets are requested, or set rules to prevent too many requests.

Interface actions that fire the On password reset requested event

• Request password reset↗

Use Cases

• Send a password reset email with a secure, time‑limited link
• Throttle repeated requests to prevent abuse
• Log attempts and notify security tools if unusual activity is detected

Event data

Display Key	Example Value	Description
user	{ id: "b20fd6fd-...", email: "user@example.com" }	The user requesting a reset.
token	"eyJhbGciOi..."	One‑time token used to validate the reset.
url	"https://your-domain.com/reset-password?token=...&redirect_url=..."	Complete, ready‑to‑use reset link (includes token and your redirects).

Example payload

{
  "user": {
    "id": "b20fd6fd-aa0a-44c2-8429-2e39cc4d59b4",
    "email": "user@example.com"
  },
  "token": "eyJhbGciOi...",
  "url": "https://your-domain.com/reset-password?token=...&redirect_url=https://your-app.com/signed-in"
}

Send the reset email

For most projects, this Event Trigger should use WeWeb's built-in backend Send Email action.

Recommended setup

1. Open Data & API → Workflows → Event triggers.
2. Open On password reset requested.
3. Add the backend Send Email action.
4. Bind the recipient to user.email.
5. Set a subject such as Reset your password.
6. In the message body, include the url value from the event data so the user can open the reset page.

What you need to bind

• Recipient: user.email
• Subject: Your password reset email subject
• Content: The url value somewhere in the text or HTML

Example HTML snippet:

<p>Hi,</p>
<p>Click the link below to reset your password:</p>
<p><a href="{{url}}">Reset password</a></p>
<p>If you didn’t request this, you can ignore this email.</p>

Alternative: use an email integration

If you need provider-specific features, you can use an email integration such as Resend, SendGrid, or Postmark instead.

View full list of email sending integrations →