Developer Documentation

Webhook Retry Policy

Understand the FundraiserMax webhook retry policy including exponential backoff, failure thresholds, and automatic disabling.

Retry Policy

If your webhook endpoint does not respond with a 2xx status code within 10 seconds, FundraiserMax will retry the delivery using exponential backoff.

Retry Schedule

AttemptDelay After PreviousApproximate Time After First
1 (initial)Immediate0 seconds
21 minute1 minute
35 minutes6 minutes
430 minutes36 minutes
52 hours~2.5 hours

Automatic Disabling

If a webhook endpoint fails 5 consecutive deliveries (across any events), FundraiserMax will automatically disable the webhook and send an email notification to all account admins. You can re-enable the webhook from the Settings page after resolving the issue.

Best practice: Monitor your webhook endpoint health and set up alerting for failures. Return a 200 status code as quickly as possible — process the event asynchronously if it requires heavy computation.