Send Lead API

Overview

This is a work in progress. This document describes how to submit leads directly to Netsville via an HTTP POST Request. Requests are submitted to a CGI script with Key-Value Pairs in the BODY of the request.

Request Requirements

Only POST requests are allowed.

Test Server

Currently, just the testing server is available. Here is the main URI:

http://devel3.netsville.com/us-social-security-disability.com/admin/sendlead.php

Description of Form Fields

Field	Description	Type	Required	Example
affiliate_id	Unique identifier given to you by Netsville	Alphanumeric	Yes	ABC123
name_last	Last Name of Person	Alpha	Yes	Smith
name_first	First Name of Person	Alpha	Yes	John
dob	Date of Birth in YYYY-MM-DD format	Date	Yes	1985-01-15
email	Email address	Email	Yes	jsmith@example.com
phone_home	10 digit home phone number in NNNXXXYYYY format (numbers only)	Numeric	Yes	5855551212
addr_street	Street address	Alphanumeric	Yes	123 Main Street
addr_city	City	Alpha	Yes	Rochester
addr_state	State (two letter abbreviation)	Alpha	Yes	NY
addr_zip	Zip code (5 number)	Numeric	Yes	14614
disability	What is the condition that prevents you from working?	Alpha	Yes	A-Fib, heart condition, dizziness
out_of_work_yn	Do you expect to be out of work for the next 12 months? Either Yes(Y) or No(N)	Alpha	Yes	Y
stop_work_date	The date that you stopped working in YYYY-MM-DD format	Date	Yes	2009-11-30
applied_yn	Have you applied for Social Security Disability? Either Yes(Y) or No(N)	Alpha	Yes	Y
applied_result	What was the result of your application? The possible choices are: Claim Pending, Receiving Benefits, Claim Denied. The answer must contain one of these words: 'pending', 'benefits', or 'denied'	Alpha	Yes	denied
applied_denial_date	If the above answer contains 'denied', then this field must contain the date of that denial in the format: YYYY-MM-DD. Otherwise, this field can be empty.	Date	No	2010-12-31
work_half_yn	Have you worked 5 out of the last 10 years? This field can be empty.	Alpha	No	N
talk_to_lawyer_yn	Would you like a free consultation (speak to a laywer)? If this is blank, YES(Y) is assumed.	Alpha	No	Y
doc_yn	In the past 6 months, have you seen a doctor? Either Yes(Y) or No(N). This field can be empty.	Alpha	No	N
have_lawyer_yn	Do you currently have an attorney helping you? Either Yes(Y) or No(N). This field can be empty.	Alpha	No	N
is_test_lead	A trigger to mark lead as only a test in the database. Use '1' for Yes and '0' for No. This field can be empty.	Numeric	No	0