Webhooks API

View Logs

GET /api/v1/webhooks/logs?page=1&per_page=20
Authorization: Bearer {jwt}

Get Log Detail

GET /api/v1/webhooks/logs/{id}
Authorization: Bearer {jwt}

{
  "id": "wh_abc123",
  "event": "delivered",
  "message_id": "msg_abc123",
  "url": "https://yourapp.com/webhook",
  "status_code": 200,
  "attempts": 1,
  "created_at": "2026-03-07T12:00:05Z"
}

Retry Webhook

POST /api/v1/webhooks/logs/{id}/retry
Authorization: Bearer {jwt}

Webhook Statistics

GET /api/v1/webhooks/stats
Authorization: Bearer {jwt}

Returns aggregate statistics:

{
  "total": 1500,
  "successful": 1480,
  "failed": 20,
  "avg_latency_ms": 250
}

Provider Webhooks

Dispatch receives webhooks from email/SMS providers for delivery status updates:

POST /api/v1/webhooks/{provider}

Supported providers: ses, resend, mailersend, twilio.

These endpoints are public (authenticated by provider-specific signatures) and update message status automatically.