Lead Webhook Issues

This guide helps you troubleshoot incoming lead webhooks so new leads from external sources (ad forms, landing pages, CRMs) reliably reach ABC Sales AI.

Webhook Returns an Error

Issue: The system sending the webhook reports a failure or a non-success status code.

Possible Causes:

1. The webhook URL is incorrect or has changed
2. The authentication token or secret is missing or wrong
3. The request payload is not valid JSON
4. The sending service cannot reach our endpoint

Solutions:

• Copy the exact webhook URL from your ABC Sales AI settings and confirm it has no extra spaces
• Include the required authentication header or token on every request
• Validate that the payload is well-formed JSON before sending
• Check the status page for any endpoint outages

Lead Is Not Created

Issue: The webhook returns success, but no lead appears.

Possible Causes:

1. Required fields (such as name or phone number) are missing from the payload
2. Field names in the payload do not match the expected mapping
3. The lead was deduplicated against an existing contact
4. A filter or routing rule excluded the lead

Solutions:

• Confirm the payload includes all required fields with the correct field names
• Review your field mapping so incoming keys map to the right lead attributes
• Check whether the lead matched an existing contact and was merged instead of created
• Review any inbound filters or routing rules that could drop the lead

Lead Is Created but Data Is Incomplete or Wrong

Issue: The lead appears, but some fields are empty or contain the wrong values.

Possible Causes:

1. Mismatched or partial field mapping
2. Data formatted unexpectedly (for example phone numbers without a country code)
3. Nested fields in the payload that are not mapped

Solutions:

• Audit the field mapping end to end and add any missing fields
• Normalize values at the source (use international phone format such as +15551234567)
• Flatten or explicitly map nested payload fields

Verifying the Webhook

> Tip: Send a test request with a known sample payload before going live. This confirms the URL, authentication, and mapping all work together.

• Send one test lead and confirm it appears with the correct data
• Review delivery logs on the sending platform for the response we returned
• Once verified, enable the live integration

Still Having Issues?

If leads still fail to arrive:

• Capture the exact request payload and the response status code
• Note the source platform sending the webhook
• Contact our support team with these details and the approximate time of the failed request