import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.webhooks.events.list({
webhookId: '4dd369bc-aa82-4ff3-97de-514ae3000ee0',
});
curl -X GET 'https://api.resend.com/webhooks/4dd369bc-aa82-4ff3-97de-514ae3000ee0/events' \
-H 'Authorization: Bearer re_xxxxxxxxx'
{
"object": "list",
"has_more": false,
"data": [
{
"id": "msg_1srOrx2ZWZBpBUvZwXKQmoEYga2",
"type": "email.sent",
"created_at": "2026-08-22T15:28:00.000Z",
"status": "success"
},
{
"id": "msg_1srOsB4mXhCqCVwAxYRNnpFZhb3",
"type": "email.delivered",
"created_at": "2026-08-22T15:27:42.000Z",
"status": "failed"
}
]
}
List Events
Retrieve a list of events delivered to a webhook.
GET
/
webhooks
/
:webhook_id
/
events
import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.webhooks.events.list({
webhookId: '4dd369bc-aa82-4ff3-97de-514ae3000ee0',
});
curl -X GET 'https://api.resend.com/webhooks/4dd369bc-aa82-4ff3-97de-514ae3000ee0/events' \
-H 'Authorization: Bearer re_xxxxxxxxx'
{
"object": "list",
"has_more": false,
"data": [
{
"id": "msg_1srOrx2ZWZBpBUvZwXKQmoEYga2",
"type": "email.sent",
"created_at": "2026-08-22T15:28:00.000Z",
"status": "success"
},
{
"id": "msg_1srOsB4mXhCqCVwAxYRNnpFZhb3",
"type": "email.delivered",
"created_at": "2026-08-22T15:27:42.000Z",
"status": "failed"
}
]
}
Webhook events and delivery attempts are currently in private beta and only
available to a limited number of users. APIs might change before it is
generally available. Get in touch if you’re
interested in testing this feature.Once you have access, upgrade your Resend SDK to use the methods on this
page:
npm install resend@6.19.0-preview-headless-dashboard.4
Path Parameters
string
required
The Webhook ID.
Query Parameters
number
Number of events to return. Between
1 and 100. Defaults to 20.string
The event ID to fetch the next page after.The
before parameter is not supported for this endpoint.Response Fields
string
Always
list.boolean
Whether more events exist beyond this page.
array
The events delivered to this webhook, most recent first.
Hide properties
Hide properties
string
The event ID. Use this to retrieve its details
or list its attempts.
string
The event type, for example
email.sent.string
When the event was created.
string
Delivery status of the event to this webhook:
success, failed,
attempting, or pending.import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.webhooks.events.list({
webhookId: '4dd369bc-aa82-4ff3-97de-514ae3000ee0',
});
curl -X GET 'https://api.resend.com/webhooks/4dd369bc-aa82-4ff3-97de-514ae3000ee0/events' \
-H 'Authorization: Bearer re_xxxxxxxxx'
{
"object": "list",
"has_more": false,
"data": [
{
"id": "msg_1srOrx2ZWZBpBUvZwXKQmoEYga2",
"type": "email.sent",
"created_at": "2026-08-22T15:28:00.000Z",
"status": "success"
},
{
"id": "msg_1srOsB4mXhCqCVwAxYRNnpFZhb3",
"type": "email.delivered",
"created_at": "2026-08-22T15:27:42.000Z",
"status": "failed"
}
]
}
Was this page helpful?
⌘I