API · Webhooks

Retrieve Event

Retrieve an event’s payload, delivery status, and next attempt time (requires full access).

GET/webhooks/{webhook_id}/events/{event_id}Full access

Request parameters

Parameter	Type	Description
`webhook_id` path · required	`string`	The Webhook ID.
`event_id` path · required	`string`	The Webhook Event ID.

Request example

Set OPENSEND_BASE_URL=https://api.example.com and OPENSEND_API_KEY=os_replace_me on your server.

bash

curl -X GET "$OPENSEND_BASE_URL/webhooks/YOUR_webhook_id/events/YOUR_event_id" \
  -H "Authorization: Bearer $OPENSEND_API_KEY"

Response

200 · application/json. Example IDs stand for IDs returned by your installation.

json

{
  "object": "webhook_event",
  "id": "msg_1srOrx2ZWZBpBUvZwXKQmoEYga2",
  "type": "email.sent",
  "created_at": "2026-08-22T15:28:00.000Z",
  "status": "attempting",
  "next_attempt_at": "2026-08-22T15:33:00.000Z",
  "payload": {}
}

Behavior and errors

The event must belong to the webhook in the URL. Status is pending, attempting, success, or failed. Inspect payload and next_attempt_at when diagnosing a delivery.

Use a full-access credential. Unknown or foreign resources return 404. See authentication, errors, rate limits, and pagination.