Skip to main content

Why was my webhook disabled?

If you received an email saying that your webhook has been disabled, Alloy detected repeated delivery failures and automatically paused the webhook to prevent continued unsuccessful requests.

What does “exceeded the error tolerance” mean?

Alloy retries webhook deliveries when the receiving endpoint or network encounters an error. A webhook is automatically disabled when it fails to deliver 100 times continuously within a 72-hour period.

This safeguard usually indicates an issue with the receiving endpoint, such as:

  • The endpoint is returning a 5XX server error.

  • The endpoint is timing out or not responding successfully.

  • Authentication credentials or tokens are invalid or expired.

  • The webhook URL is incorrect, unreachable, or no longer active.

  • The server’s TLS/SSL certificate or certificate chain cannot be verified.

Review the webhook logs

Use Webhook Logs to identify the response or exception causing the delivery failures.

  1. In the Alloy dashboard, go to Settings > Webhook Logs.

  2. Search or filter for the affected webhook.

  3. Open a log entry to review the Endpoint, Response, Exception, Attempt, and payload details.

  4. Review previous retry attempts for the same webhook event.

The response code and exception message can help identify whether the issue is related to your application server, authentication, network access, URL configuration, or TLS/SSL certificate.

Resolve the receiving endpoint issue

Work with the team that owns the receiving endpoint to correct the cause of the failures. For example:

  • For 5XX responses, review the server or application logs for the corresponding request.

  • For timeouts, confirm that the endpoint responds within the expected time.

  • For authentication errors, verify that the credentials configured in Alloy are current.

  • For URL or network errors, confirm that the endpoint is active and reachable from Alloy.

  • For certificate errors, verify that the server presents a valid, complete certificate chain.

After making a change, confirm that the endpoint can accept Alloy webhook requests and return a successful response.

Re-enable the webhook

After you resolve the endpoint issue, re-enable the webhook from the Alloy dashboard:

  1. Go to Settings > Webhooks.

  2. Locate the disabled webhook.

  3. Set the webhook to active.

  4. Save the change, if prompted.

New webhook events will begin sending again after the webhook is re-enabled. If the endpoint continues returning errors, the webhook may reach the failure threshold again and be disabled a second time.

Did this answer your question?