Skip to navigation

Retry mechanism

View as Markdown

The retry mechanism resends webhook event requests that fail on the first attempt. Requests can fail for several reasons, including connection timeouts and client-side issues. Key points about retries:

  • If the client’s servers are unresponsive, webhook event requests are paused for 10 minutes and then resumed.

  • 4xx response codes, except for 429, and any 5xx response code stop all retry attempts and discard the webhook.

  • There are 4 retry attempts, in addition to the original request.

    Each retry is sent with the following increments:

    • 1st attempt: 10 min
    • 2nd attempt: 1 hour
    • 3rd attempt: 2 hours
    • 4th attempt: 8 hours

    Reference example showing the retry mechanism runtime:

    Attempt NumberDelayTime
    T1- Original attempt010:00 am
    T1 + 10 min10 min10:10 am
    T2 + 1 hour1 hour11:10 am
    T3 + 2 hours2 hours1:10 pm
    T4 + 8 hours8 hours9:10 pm

This example includes the original attempt Brevo sends to the notify URL before failure, for 5 requests in total.