Life Docs

Ping and Post Lead Fields

Field Post Required Ping Required Detail Data Type Values Allowed Example
leadtype Yes Yes 3 letter product code text (3) lif lif
affid Yes Yes Your affiliate id provided by ABCLeads number 1005
firstName Yes n/a First name of lead text John
lastName Yes n/a Last name of lead text Prospect
address1 Yes n/a Address line 1 text 123 Main Street
address2 No n/a Address line 2 text Apt 23
city Yes n/a Lead City text Providence
state Yes n/a Lead State text AL
AK
AZ
AR
CA
CO
CT
DE
DC
FL
GA
HI
ID
IL
IN
IA
KS
KY
LA
ME
MD
MA
MI
MN
MS
MO
MT
NE
NV
NH
NJ
NM
NY
NC
ND
OH
OK
OR
PA
RI
SC
SD
TN
TX
UT
VT
VA
WA
WV
WI
WY		 RI
zip Yes Yes Lead Zipcode number 02901
phone1 Yes n/a Lead phone number number 4011234567
phone2 No n/a Lead alternative phone number number 4011234567
email Yes n/a Lead email address text something@example.com
bestcall Optional Optional Best time to call text morning
afternoon
evening
any time		 morning
typeinsurance Optional Optional Type of Insurance text
tobacco Optional Optional Used Tobacco Products in the past year text
sex Optional Optional Gender text Male
Female		 Male
who Optional Optional Who the quote is for text Self
Spouse
Sibling
Child
Parent
Grandparent
Grandchild		 Self
rated Optional Optional Ever been rated or turned down for life insurance text Yes
No		 Yes
termtype Optional Optional Type of Term Insurance text
howmuch Optional Optional How much insurance text
birthday Yes Yes Birthday text
currentpayment Optional Optional Existing policy payments text
paymentfrequency Optional Optional How often existing payments are made text
height Yes Yes height text
weight Yes Yes weight text
heartorcancer Optional Optional History of heart disease or cancer text
takemeds Optional Optional Take Medication text
medications Optional Optional Medications taken text
comments Optional Optional Comments text
tcpa_consent Yes Yes Lead Agreed to TCPA Complience text yes
no		 yes
tcpa_language Yes Yes TCPA language they agreed to text
phone_type Yes Yes Phone Number Type text mobile
landline
unknown		 mobile
subid Optional n/a Lead identifier text LEAD45697
source Yes Yes Your source or channel identifier text PPC6547
source_type Yes Yes The type of source that drove this lead text Search Organic
Search Paid
Email
Coreg
Banner Link
Call Center
Piggyback
Non-Mobile Site
Conquest
Unknown
Mobile Site
Mobile App
Other		 Email

Ping

The ping checks if a buyer is available for the lead that you want to sell us. Using Dynamic ping url will display the commission that we will pay you for the lead if you decide to post us the full lead. Static URL uses the agreed upon price as seen inside your affilaite account by product.

Static Ping URL: https://www.abcleads.com/xmlpost/ping.php

Dynamic Ping URL: https://www.abcleads.com/xmlpost/pingxml.php

Example

Request Response 
<?xml version="1.0" encoding="ISO-8859-1"?>
<ping> 
	<affid>1005</affid> 
	<protype>lif</protype> 
	<zip>02889</zip>
	<exclusive>true</exclusive>
	<source>1234</source>
	<source_type>Email</source_type>
</ping>
 
<?xml version="1.0" encoding="ISO-8859-1"?>
<ping>
  <approved>1</approved>
  <payout>15.23</payout>
  <pingid>ABC123456789123</pingid>
  </ping>

Ping Response

A breakdown of the ping response

Field Detail
approved Either a 1 or 0 is returned. 1 means we will accept the lead. 0 means we will not.
payout What ABCLeads will set the commission for this lead
pingid Ping ID. Needs to be sent on the post in order for the post to be accepted.

Ping Errors

If an error occurs on the post the response would look similar to this:

Response 
<?xml version="1.0" encoding="ISO-8859-1" ?>
	<ping>
		<approved>0</approved>
		<error>Error Text Here</error>
  	</ping>

Post

After a successful ping ABCLeads can then accept the posting of the full lead data.

Post URL: http://services.abcleads.com/post

Static Post URL: https://www.abcleads.com/xmlpost/xml.php

Dynamic Post URL: https://www.abcleads.com/xmlpost/postxml.php

Example

Request Response 
<?xml version="1.0" encoding="ISO-8859-1"?>
<Leads>
  <lead>
    <leadtype>lif</leadtype>
    <affid>1005</affid>
    <firstName>John</firstName>
    <lastName>Prospect</lastName>
    <address1>123 Main Street</address1>
    <address2>Apt 23</address2>
    <city>Providence</city>
    <state>RI</state>
    <zip>02901</zip>
    <phone1>4011234567</phone1>
    <phone2>4011234567</phone2>
    <email>something@example.com</email>
    <bestcall>morning</bestcall>
    <typeinsurance></typeinsurance>
    <tobacco></tobacco>
    <sex>Male</sex>
    <who>Self</who>
    <rated>Yes</rated>
    <termtype></termtype>
    <howmuch></howmuch>
    <birthday></birthday>
    <currentpayment></currentpayment>
    <paymentfrequency></paymentfrequency>
    <height></height>
    <weight></weight>
    <heartorcancer></heartorcancer>
    <takemeds></takemeds>
    <medications></medications>
    <comments></comments>
    <tcpa_consent>yes</tcpa_consent>
    <tcpa_language></tcpa_language>
    <phone_type>mobile</phone_type>
    <subid>LEAD45697</subid>
    <pingid>ABC50F6FA4220247</pingid>
    <source>PPC6547</source>
    <source_type>Email</source_type>
  </lead>
</Leads>
 
<?xml version="1.0" encoding="ISO-8859-1" ?>
	<lead>
		<leademail>something@example.com</leademail>
		<approved>1</approved>
		<lead_id>LIF12345</lead_id>
        </lead>

Post Errors

If an error occurs on the post the response would look similar to this:

Response 
<?xml version="1.0" encoding="ISO-8859-1" ?>
	<lead>
		<approved>0</approved>
		<leademail>something@example.com</leademail>
		<errors><error>Error Text Here</error></errors>
        </lead>