Skip to main content

Retry Behavior

When your 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, your 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 your 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​