Skip to content
  • There are no suggestions because the search field is empty.

Why am I getting "Your webhooks are failing" emails?

This guide explains why you receive webhook failure alerts, how to fix or manage the endpoint, and what happens if an endpoint continues to fail.

When Alerts Are Sent

  • Alerts are emailed to the account owner and the alerts email address configured in Widget Settings.
  • An initial warning email is sent after an endpoint has zero successful (2xx/3xx) responses for a full day.
  • Partially failing webhooks (where only some event types fail while others succeed) are never disabled; Truv will only send a notification.
Note: Verifications are still running normally: Nothing about the borrower experience changes.

What to Do When a Webhook Fails

  1. Locate the endpoint: Log in at dashboard.truv.com and go to Development → Webhooks in the left-hand menu. This lists every webhook endpoint on your account, by the same name shown in the alert email — for example, order-updates.
  2. Open the delivery logs: Go to Development → Logs, then the Webhook tab. Use the All webhooks filter to narrow the list to the endpoint from the alert. Selecting any failed delivery shows the error code your system returned, its full response, and exactly what Truv sent — usually enough for your technical team to identify the cause immediately.
  3. Verify environment: Ensure you are in the correct environment (Production vs. Sandbox). Old test endpoints often cause unexpected alerts.
  4. Notify your technical team: Forward the alert details (endpoint name, failure count, date range) to your IT team or software vendor.
  5. Disable or delete unneeded webhooks: Toggle off or delete unused test endpoints under Development → Webhooks to stop alerts.

What Happens If the Endpoint Isn't Fixed

  • Day 1 (Warning Email): Truv sends an initial warning email after an endpoint has no successful responses for 24 hours.
  • 3+ Days Later (Disabling): If the endpoint is still failing three or more days after that initial warning—and has not succeeded once since—Truv sends a final notification email and disables the endpoint.
  • Re-enabling: Disabled webhooks are never re-enabled automatically. Once the endpoint is resolved, you can re-enable it at any time in the Dashboard or via the API.

Updating Alert Contacts

Alerts are sent to the Account Owner and the designated Alerts Email Address. Update this address in your Dashboard settings to route alerts to a different team.

Submitting a Support Ticket

If logs show unexplained errors and your technical team is unable to resolve the issue, contact Truv Support at Support@truv.com with:

  1. Category & Details: Select the issue category and include the Endpoint Name, Environment, and Date Range.
  2. Logs & Context: Attach error logs/screenshots and describe expected vs. actual results.