Replay failed webhooks

POST https://app.speybooks.com/api/v1/admin/system/replay-webhooks

Re-queue failed webhook events for reprocessing. Accepts an array of webhook event IDs (1–50 per request).

Only events with status = 'failed' are eligible. The endpoint resets their status to pending, clears error_details, and increments retry_count.

Returns 400 if none of the provided IDs match failed events.

Side Effects

  • Writes WEBHOOKS_REPLAYED to admin_audit_log

Note

This resets the status but does not re-invoke the webhook processor. A background worker or manual trigger is needed to process pending events.

Body parameters

webhookIds array<integer> required
Array of failed webhook event IDs to replay (1-50).
min items: 1 · max items: 50

Response

200 Webhooks queued for replay.
Show response fields
message string
webhookIds array<integer>

Error codes

400 No failed webhooks found with the provided IDs.