Overview
Lead Validation is a tool allowing Lead Resellers to determine if a Lead meets an Admin's acceptance criteria without sharing as much information as a typical Lead Search. Together with Lead Criteria, Admins can ensure the Leads they buy are best suited to their needs.
Contents
Before You Begin
To learn more about API and Convoso's API Menu options, see API Menu Options Documentation.
There are three required Arguments for the vendor's Request Query String:
- API Authentication Token
- Lead Criteria Key
- Lead's Phone Number
To learn more about Lead Criteria Filters, see Lead Criteria.
Note: Our system accepts HTTP POST in RAW format. We do not support nested parameters or multilevel arrays.
Lead Validation API
1.) Click the API menu.
2.) Click the Lead Validation menu option.
The Lead Validation page will open.
3.) Check the required fields in the Arguments section.
4.) Click the Test Request tab.
5.) Configure the fields for your test.
- (A) auth_token: Select the correct Authorization Token in this drop-down.
- (B) criteria_key: Enter the criteria key from your Lead Criteria Filter.
- (C) phone_number: Enter the phone number you want to validate.
6.) Check the Show Query checkbox.
7.) Click the green Run button.
If everything is configured correctly, the JSON Response will show as a success and display all of the information about the searched Leads.
-
Accepted:
- The Lead was not found in the Account, and it meets the criteria provided by the Admin.
- The Lead was found in the Account, meets the criteria, and has reached the lead age requirements.
-
Declined:
- The Lead does not meet the requirements for the criteria provided by the customer, regardless of whether or not the system found it within the Account.
- The system found the Lead on the DNC List.
Please sign in and vote to let us know if you found this article helpful!
👇