Skip to main content

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:

Webhook features

With Resend’s webhook features, you can:

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.
See a step-by-step example of creating a webhook through the Dashboard, including testing and deployment.

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.
See how to use Resend’s webhook features such as replaying webhooks and storing webhook data in the webhooks 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.