Skip to main content

Retry Behavior

When the endpoint returns a non-2xx HTTP response or the request times out, eCourtDate will automatically retry delivery of the webhook event.

Endpoint Requirements​

To ensure reliable webhook delivery, the endpoint should follow these guidelines:

  • Return HTTP 200 quickly: respond within a few seconds to avoid timeouts
  • Process asynchronously: if handling the payload requires significant work, queue it for background processing and return 200 immediately
  • Be idempotent: the same event may be delivered more than once due to retries, so ensure the processing logic can safely handle duplicate deliveries
tip

Always return a 200 response immediately, then process the webhook payload in the background. This prevents timeouts and unnecessary retries.

Handling Duplicates​

Use the uuid field in the webhook payload to detect duplicate deliveries. Store processed event UUIDs and skip any that have already been handled.

Next Steps​