1663832908583941.png)
Built with DocStar1️⃣ How Webhook Responses Are Treated
When we send a webhook to your server, your system responds with an HTTP status code.
We classify responses like this:
✅ 2XX (Success)
Example: 200, 201
This means your server received the webhook successfully.
👉 No retry is needed.
❌ 4XX or 5XX (Error)
Example: 400, 404, 500
This means something went wrong.
👉 The system will retry sending the webhook.
2️⃣ How Retry Logic Works (Very Important)
If your webhook fails, we don’t stop immediately.
We retry multiple times using increasing delay intervals.
Here’s how it works:
Attempt | Delay Before Retry | Total Time Passed |
|---|---|---|
1st Retry | 30 seconds | 30 seconds |
2nd Retry | 1 minute | 1 minute 30 seconds |
3rd Retry | 5 minutes | 6 minutes 30 seconds |
4th Retry | 15 minutes | 21 minutes 30 seconds |
5th Retry | 30 minutes | 51 minutes 30 seconds |
✅ Maximum retries: 5 attempts
If all 5 retries fail, the event is marked as Final Failed.
3️⃣ When Does Auto-Pause Happen?
A webhook will be automatically paused ONLY if both conditions below are met:
✅ Condition 1: Failure Rate Exceeds 2%
Failure Rate Formula:
(Final Failed Events ÷ Total Events) × 100Example:
Total webhook requests = 11
Final failed events = 3
Failure rate = 27.27%
Since 27.27% is more than 2%,
👉 The webhook will be paused.
✅ Condition 2: Minimum 10 Requests Required
Auto-pause will only be evaluated if:
Total requests ≥ 10
If fewer than 10 requests are received,
👉 Webhook will NOT be paused.
Important Clarifications
Please note the following:
Each webhook is monitored separately. (One webhook being paused does NOT affect others.)
Auto-pause is calculated only after all retries are completed.
Only final failed events are counted. (Retry failures are not counted individually.)
A single success after failures does NOT immediately reset the failure count.
Both total request count and failure count automatically reset after 48 hours. (Failure rate calculation starts fresh every 48 hours.)
Will You Receive Notification If Webhook Is Paused?
Currently:
❌ No email notification is sent.
This feature will be implemented soon.
You can check webhook status by:
👉 Going to your client panel
👉 Open Webhook Configuration
👉 You will see pause status and reason there
Best Practices to Avoid Auto-Pause
To prevent your webhook from getting paused:
Always return HTTP 200 for successful processing.
Make sure your server responds quickly.
Avoid returning 4XX or 5XX errors.
Ensure your server has enough capacity to handle webhook load.