latestOpenAPI 3.0.42026-08-194977335.3 KB

40bd25a4edaf

WebhookEvents

Replay a specific webhook event.

Re-enqueues the exact payload from a previously recorded event to its original subscription.

The event is re-queued as a fresh delivery attempt (attempt 1) using the original payload unchanged. Delivery follows the normal retry schedule if the endpoint is unavailable.

Replay signal: Replayed deliveries include the header X-Debitura-Replay: true so your endpoint can distinguish a replay from a live event and implement idempotency correctly.

When to use:

  • Your endpoint was temporarily unavailable and you want to re-deliver a specific event.
  • You want to test idempotency of your event handler.
  • Part of CI-loop ASSERT: confirm an event was dispatched via GET /webhooks/events, then replay to a different receiver.

Relationship to replay-last-event: POST /test/cases/{id}/replay-last-event is a convenience wrapper over this endpoint — it looks up the most recent event ID for you. Use that endpoint when you don't yet know the event ID; use this endpoint when you have the ID from GET /webhooks/events.

Tenant isolation: Only events belonging to your own subscriptions can be replayed.

post/webhooks/events/{id}/replay

Path parameters

idstring uuid required

Response

Event re-enqueued for delivery

eventIdstring uuid

The ID of the event that was replayed.

subscriptionIdstring uuid

The subscription the event was re-enqueued to.

eventTypestring nullable

The event type that was replayed (e.g. "case.updated").