Webhooks
Resend provides webhooks, which are real-time HTTPS requests that tell your application an event occurred, such as an email delivery notification or subscription status update. This allows you to receive real-time and actionable updates on the delivery, open, bounce, and click events of your emails. You can create, update, observe, and retry webhooks from the dashboard or via the API. Webhooks deliver a JSON payload with metadata like the from, to, and status of your email event that can be used by your application. Use webhook feeds for common workflows such as:- Automatically remove bounced email addresses from mailing lists.
- Create alerts in your messaging or incident tools based on event types.
- Store all send events in your own database for custom reporting/retention.
- Receive inbound emails from your application.
Webhook features
With Resend’s webhook features, you can:- Replay any webhook event. This is useful when your endpoint missed an event, or when you want to reprocess events with updated handler code.
- Verify webhook requests to ensure their authenticity.
- Listen for webhook events locally during development.
- Self-host the Resend Webhook Ingester to store all your webhook events with an open-source, ready-to-deploy solution that handles all the complexity for you.
Quickstart
Get started by creating a webhook to incorporate Resend into your application. To receive real-time events in your app via webhooks, you need to:1
Create an endpoint in your application
Create a route that can accept POST requests. This route will listen for and
receive events from Resend.
2
Add a webhook in Resend
Define a webhook with the URL of your endpoint, and the email
events it handles.
Choose your infrastructure
After creating your application endpoint, you can define and manage your webhooks entirely from the Resend Dashboard. This allows all members of your team to have full access to your email event data and to perform any necessary maintenance. To build workflows to manage and respond to email events from your application, you can use a variety of tools:- SDK: build and manage webhooks with an SDK built for your language
- Integrations: build workflows with a framework or tool you already use
- API: manage webhooks with raw cURL calls
- CLI: register endpoints and listen for email event notifications from the terminal.
- MCP: build workflows that respond to email events through your agent using natural language.
Related Guides
Create webhook
Respond to emails
Retry replay webhooks
Email event types
Verify a webhook request
Store webhook data
Self-host the Resend Webhook Ingester
Webhook events reference
Examples
Next.js (TypeScript)
See the full source code.
Next.js (JavaScript)
See the full source code.
PHP
See the full source code.
Laravel
See the full source code.
Python
See the full source code.
Ruby
See the full source code.