OpenXSwitch - Webhook Retries
To ensure reliable delivery of events, OpenXSwitch implements a retry mechanism for webhook notifications. If your webhook endpoint fails to acknowledge a delivered event (e.g., due to downtime or network issues), OpenXSwitch will automatically attempt to resend the event.
To better understand the specific events and their status, see the Webhook Events Documentation .
Retry Policy
Acknowledgment Expectation:
- Your webhook endpoint must respond with a
2xxHTTP status code to acknowledge successful receipt of the event. - Any other response (e.g.,
4xxor5xxstatus codes) or a timeout will trigger a retry.
Retry Schedule:
- OpenXSwitch retries webhook deliveries every
5 minutesfor up to12 hours. - After
12 hours, if the webhook is still not acknowledged, the event will be marked as undelivered and no further attempts will be made.
Manually replay
- If your service fails to receive the webhooks you can manually replay it through your workspace console