Skip to documentation

API · Webhooks

List Events

List original webhook events, newest first; replaying an event does not add another entry (requires full access). Only limit and after pagination are supported; before returns an error.

GET/webhooks/{webhook_id}/eventsFull access

Request parameters

ParameterTypeDescription
webhook_id
path · required
stringThe Webhook ID.
limit
query · optional
integer
1–100
Default: 20
Number of items to return.
after
query · optional
stringReturn items after this cursor.

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" \
  -H "Authorization: Bearer $OPENSEND_API_KEY"

Response

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

json
{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "msg_1srOrx2ZWZBpBUvZwXKQmoEYga2",
      "type": "email.sent",
      "created_at": "2026-08-22T15:28:00.000Z",
      "status": "success"
    }
  ]
}

Behavior and errors

Use limit and after; before is rejected. Replays appear in the original event’s attempt history rather than as extra events.

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