Replay failed webhooks

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

Re-queue failed inbound webhook events for another attempt. Accepts an array of event IDs (1 to 50 per request). These are inbound events received from the payment provider, not outbound deliveries.

Only events currently in the failed state are eligible. Eligible events are returned to the pending state and their recorded error is cleared, ready to be attempted again.

Returns 400 if none of the supplied IDs match a failed event.

Note: re-queuing sets the state back to pending; it does not itself re-run the processing. A separate processor pass picks pending events up and works them.

Records a WEBHOOKS_REPLAYED action in the audit log.

Body parameters

webhookIdsarray<integer>required

Array of failed webhook event IDs to replay (1-50).

min items: 1 · max items: 50

Response

200Webhooks queued for replay.

Show response fields

messagestring

webhookIdsarray<integer>

Error codes

400No failed webhooks found with the provided IDs.

RequestPOST/v1/admin/system/replay-webhookscurl

curl -X POST https://api.speybooks.com/v1/admin/system/replay-webhooks \
  -H "Authorization: Bearer <admin-token>" \
  -H "Content-Type: application/json" \
  -d '{"webhookIds": [42, 43, 44]}'

Response200

{
  "success": true,
  "data": {
    "message": "3 webhook(s) queued for replay",
    "webhookIds": [
      42,
      43,
      44
    ]
  }
}