Skip to main content

Events, Deliveries, and Attempts

Praeto Dispatcher separates webhook delivery into three records.

Event

An event is the publisher-side object accepted by Praeto.
{
  "event_type": "invoice.created",
  "payload": {
    "invoice_id": "inv_001"
  }
}
The event stores event_id, tenant_id, event_type, payload, idempotency_key, payload_hash, and created_at.

Delivery

A delivery is the planned delivery of one event to one endpoint. One event can create many deliveries if multiple endpoints subscribe to the event type. Delivery statuses include pending, delivered, failed, and dead_lettered.

Attempt

A delivery attempt records each outbound HTTP try, including status code, response body, and creation timestamp.