This guide will be removed on April 29, 2022. Please use our new, easier-to-use Toast technical documentation site. All updated content is on the new site.

Back-off support

In order to protect the Toast platform from outages, breakage, or delays with webhook endpoints, the Toast platform includes back-off functionality that temporarily disables a webhook subscription based on pre-defined error rates. The back-off support follows these rules:

  • If a webhook endpoint returns fifty or more errors during a five-minute interval, the subscription is paused for one minute.

  • If a webhook endpoint is paused nine times during a ten-minute interval, then the subscription is stopped and you must contact Toast support to restart it.

If a webhook endpoint is paused or stopped, messages are not sent to that endpoint and an email is sent to notify you of the paused or stopped endpoint. An additional email notification is sent when a stopped endpoint has been restarted (no email notification is sent when the Toast platform resumes sending messages to a paused endpoint).