Webhook delivery

Workwae retries a failed webhook delivery for up to 3 days and disables an endpoint that keeps failing. Use the delivery log to see what happened, replays to resend events, and test events to check a receiver.

Retries and auto-disableCopy Anchor Link

An attempt fails when your endpoint does not answer 2xx within 10 seconds: an error status, a 3xx, a timeout or a refused connection.

• Throttled attempts and Workwae-side outages do not count as attempts or toward the 72 hours; the 3-day limit still applies. A throttled delivery does not hold back other deliveries to your endpoint.
• Outage attempts still appear in the delivery log.
• failingSince and lastSuccessAt on the endpoint show its health before it is disabled.

Recover a disabled endpointCopy Anchor Link

A disabled endpoint receives no new events, and its queued deliveries wait. Deliveries still queued 3 days after they were created are given up and marked failed. Failed deliveries are deleted after 30 days.

Delivery logCopy Anchor Link

Every attempt is logged with its HTTP status, latency, error and the first kilobyte of your response. The log keeps the last 500 attempts per endpoint, for up to 7 days. The endpoint's console page shows new attempts (a retry, a delivery, the final failure) without a reload.

curl "https://api.workwae.com/v1/webhooks/$ENDPOINT_ID/attempts?result=failed&eventType=message.created" \
  -H "Authorization: Bearer $WORKWAE_API_KEY"

Results are newest first. Each attempt says whether it came from a replay (isReplay) or a test (isTest).

Replay eventsCopy Anchor Link

A replay queues events again for one endpoint, with the same id and body as the first delivery and a fresh signature. All replay requests answer 202; the attempts show up in the delivery log.

curl -X POST "https://api.workwae.com/v1/webhooks/$ENDPOINT_ID/replay" \
  -H "Authorization: Bearer $WORKWAE_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "since": "2026-05-04T00:00:00Z", "until": "2026-05-05T00:00:00Z" }'

• GET /v1/webhooks/{endpointId}/failed-deliveries/count returns how many events a replay of failed deliveries would queue. The console's Replay failed shows it before you confirm.
• A replay of failed deliveries replaces them: calling it again does not send the same events twice.
• Events already queued for the endpoint are not queued twice; the response counts them in alreadyQueued.

Test eventsCopy Anchor Link

Send an event of any type to one endpoint, whatever its filters, to build and check a receiver before real traffic exists. The request answers 202 once the delivery is queued. The console's endpoint page has a Send test event action for the same thing.

curl -X POST "https://api.workwae.com/v1/webhooks/$ENDPOINT_ID/test" \
  -H "Authorization: Bearer $WORKWAE_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "eventType": "message.created" }'

• Without eventType, the test is a webhook.test event.
• The body carries the type's sample data from the event catalog, unless you pass data, which must match that type's data (400 otherwise).
• It is signed like any other delivery, and its body has "isTest": true, webhook.test included.
• Test events never appear in the change feed.

Webhook testerCopy Anchor Link

The console's Webhook tester (admins and owners) gives you a URL on the API that records every request sent to it. Watch deliveries arrive without a receiver of your own.