Supplier Validation Error Details

Validation Error Details is a campaign-level setting that adds rejection reason information to supplier API responses when a lead is rejected by a third-party validation integration. Instead of returning a generic error, your suppliers receive specific details about which provider rejected the lead and why.

Why Use It

When a lead is rejected by a validation integration (e.g., an email verifier flags an invalid address), your supplier typically sees a generic rejection response. This often leads to back-and-forth support requests — "Why was my lead rejected?"

With Validation Error Details enabled, the supplier's API response automatically includes the rejection reason, helping them:

• Understand exactly why a lead was rejected.
• Fix data quality issues at the source.
• Reduce support tickets and communication overhead.

Where to Find It

Navigate to your campaign's edit page and open the Campaign Settings section. Scroll down to find the Validation Error Details toggle.

Enabling the Feature

1. Open your campaign's Settings section.
2. Find the Validation Error Details toggle.
3. Turn it on.

When enabled, two additional options appear: field selection and supplier scope.

Configuring Fields

Choose which details to include in the supplier's rejection response:

Toggle each field on or off independently. At least one field should be enabled for the feature to be useful.

Example

When both fields are enabled, a supplier's rejection response might include:

{
  "id": "Ajd9Sw1-7kerTs3_Ak9v",
  "status": "ERROR",
  "error_code": 1015,
  "message": "Error: lead failed validation",
  "error_meta": {
    "provider_name": "Blacklist Alliance",
    "description": "Phone is blacklisted. Results: 1; Code: anti-telemarketing,plaintiff-secondary"
  }
}

The exact response format depends on your campaign's response configuration, but the additional fields are appended to whatever error response your campaign normally returns.

Supplier Scope

Control which suppliers receive the validation error details:

All Suppliers

Every supplier connected to this campaign receives validation error details in their rejection responses. This is the simplest option and works well when you have open relationships with all your suppliers.

Specific Suppliers

Hand-pick which suppliers receive the details. When you select this option, a multi-select dropdown appears where you can choose individual supplier connections.

Use this when:

• You want to share details with trusted suppliers but not all of them.
• Some suppliers need the information to improve data quality, while others don't.
• You prefer not to reveal your validation stack to certain suppliers.

To add or remove suppliers from the list, use the dropdown to select or deselect connections.

Lead Timeline

In addition to the supplier-facing API response, validation error details are also visible in the lead detail timeline within Lead Prosper.

When viewing a lead that was rejected by a validation integration, the timeline shows:

• The validation provider that rejected the lead.
• The error message describing why it was rejected.

This gives you instant visibility into rejection reasons without needing to cross-reference logs or check the validation provider's dashboard.

Important Notes

• Campaign-level setting. This is configured per campaign. Enable it on each campaign where you want suppliers to receive validation error details.
• Only applies to validation rejections. These details are only included when a lead is rejected specifically by a third-party validation integration. Other rejection types (cap limits, filters, field validation errors) are not affected.
• Privacy consideration. Enabling this feature reveals which validation providers you use and the specific reasons for rejection. Consider whether this information is appropriate to share with each supplier before enabling it broadly.
• No impact on accepted leads. This setting only affects rejection responses. Leads that pass all validations are delivered normally with no additional fields.

If you have questions about configuring Validation Error Details or need help deciding which suppliers should receive the information, reach out to our support team. We're happy to help.