Overview
If a lead webhook fails to send, you can retry the webhook from the Leads screen. Retrying a webhook sends the original webhook payload again without re-sending the lead notification or creating a duplicate lead.
This is useful when a webhook endpoint was temporarily unavailable, returned an error, or failed due to a network issue.
What Happens When a Lead Webhook Fails
If MetaLocator cannot reach your Webhook or receives an HTTP status code greater than 299, an account notification will be created and delivered via email with the following subject:
"MetaLocator Webhook Error Notice"
How to Retry a Failed Lead Webhook
Log in to your MetaLocator administrator account.
Go to the Leads screen.
Find the lead with the failed webhook.
Select the lead using the checkbox next to the record.
Click Retry Webhook in the toolbar.
MetaLocator will resend the original webhook payload to the configured webhook endpoint.
Review the lead log to confirm that the retry request was recorded.
What Happens When You Retry
When you retry a webhook:
The original webhook payload is sent again.
The lead itself is not re-sent.
No duplicate lead is created.
Lead email notifications are not resent.
A lead log entry is added to record the retry request.
The lead log will display the attempt as resentwebhook, including the timestamp. The Webhook Response always contains the latest response.
Identifying Leads with Failed Webhooks
Log in to your MetaLocator administrator account.
Go to the Leads under Leads > All Leads.
Notice an icon appears next to any leads with a failed webhook
This icon is shown when the recorded HTTP status code of the webhook is greater than 299.
To find leads with failed webhook in bulk, click Export and review the http_status_code and webhook_response columns.
Troubleshooting
If the retry fails again, check that:
The webhook URL is correct.
The receiving server is online.
Ensure the Interface associated with the lead has a webhook configured
The endpoint accepts the expected payload.
The endpoint is not blocking requests from MetaLocator.
The endpoint is returning a successful HTTP response and status code.
Leads that have been anonymized in alignment with data retention standards cannot have webhooks retried.
Leads associated with deleted interfaces cannot have webhooks retried.
After correcting the issue, you can retry the webhook again from the Leads screen.