My webhook keeps returning errors — how do I fix it?

Webhooks fail for three reasons: your endpoint is down, it returns non-2xx, or the request times out.

Sutrena retries failed deliveries automatically. But if your endpoint keeps failing, the deliveries pile up. Check the delivery logs: GET /api/webhooks/{id}/deliveries. Each log shows the HTTP status code, response time, and whether it succeeded.

Common issues:

Your endpoint returns 500. Something on your server is crashing. Check your server logs.

Your endpoint returns 404. The URL is wrong. Double-check the webhook URL you configured.

Timeout. Sutrena waits 10 seconds. If your endpoint takes longer, it counts as a failure. Make your handler fast — accept the webhook, queue the work, return 200.

SSL errors. The webhook URL must be HTTPS. Self-signed certs will fail.

To test: use sutrena_test_webhook or POST /api/webhooks/{id}/test. It sends a test ping so you can verify your endpoint works before real submissions arrive.