Webhook Errors
Understanding webhook error handling and retry behavior
If a webhook begins to return errors (3xx/4xx/5xx server responses), it will continue to try to deliver for 24 hours with an exponential back-off that makes attempts less and less frequently, or until 24 hours after the booking of the event passes.
Webhook Disabling
After 24 hours, the webhook is disabled if another message was not delivered successfully and the hook needs to be recreated.
This failed server response happens when Calendly sends the data to your server, but your server has gone down or has a failure on your end.
If one message (event details) fails to be received, other messages will still be sent in an attempt to make a connection.
Best Practices
- Monitor your webhook endpoint uptime
- Implement proper error handling and logging
- Set up alerts for webhook failures
- Ensure your endpoint returns a 2xx status code promptly