A webhook was turned off

Why a lead box gets disabled, what the email means, and how to get it running again.

View as Markdown

What happened

Every event a lead box sends is retried up to 18 times over about four days when your endpoint does not answer with a 2xx. When the last retry fails, Mav turns the lead box off and emails your account's admins and managers, with Mav support copied. The subject starts with Mav turned off a lead box and names the webhook URL, email address or Slack channel. Events that happen while it is off are not queued; they are gone.

Find the cause

Check your endpoint for the days before the email:

  • Timeouts. Mav waits 3 seconds to connect and 3 seconds for a reply. Reply 200 first and do the work afterwards.
  • Redirects. A 301 or 302 counts as a failure. Point the lead box at the final URL.
  • Auth. If your endpoint expects a token, set Auth to Bearer on the lead box and enter it.
  • A changed URL after a deploy or a vendor migration.

Get it running again

Fix the endpoint, then open the lead box under Settings › Lead Boxes, check its settings and click Save changes. Saving turns it back on. Use Send test to confirm a 2xx before you rely on it.

Check before it happens

Send test on any lead box posts one sample event right away and shows the result as a toast, so you can verify a new endpoint in seconds.

Still have a question?

Our team answers in the thread. Ask us anything about your account.