Residential Solar Lead Posting Instructions

Instructions

The post returns a status for the lead. If the status is POST_VALID, the lead was accepted and will be processed by Clean Energy Experts. Otherwise, the lead was not accepted by Clean Energy Experts and may be distributed else where.

Post URL

https://receiver.ceeleads.info/leads/submit

Post Fields

Field Name	Data Format	Size	Description
Static Fields
campid	[provided by CEE]	-	Assigned Campaign ID
Dynamic Fields
first_name	[text]	25	First Name
last_name	[text]	25	Last Name
street	[text]	40	Street Address
city	[text]	39	City
state	[text]	2	State (abbreviation, e.g. CA, WA, AZ)
zip	#####	8	Zip Code (5-digits for US)
email	[valid email]	60	Email Address
phone_home	##########	10	Phone (10 digits, no spaces)
property_ownership	OWN RENT	12	Homeowner?
electricUtilityProviderText	[text]	Unlimited	Name of Electric Utility Company
ip_address	[text]	45	IP Address
universal_leadid	[text]	-	Valid LeadiD (www.leadid.com) associated with this lead
xxTrustedFormCertUrl	[text]	-	Valid TrustedForm certificate (https://activeprospect.com/products/trustedform/) associated with this lead

Optional Fields

Field Name	Data Format	Size	Description
willing_to_pay	Cash Some Cash Upfront No Cash Upfront Uncertain	20	Willingness to Pay
credit_rating	Bad Poor Average Good Excellent	10	Credit Rating
s1	[text]		SubID1 to track additional parameter
roof_type	Comp Shingle Clay Or Slate Tile Curved Tile - Concrete Flat Tile - Concrete Flat - Rolled Comp Or Tar And Gravel Shake - Wood; Fiber; Plastic Sheet Metal Standing Seam Metal Metal Shingle Membrane Or Foam Other Ground Mount Uncertain	100	Roof Type
file_3rd_party	[url]		HTTP link to audio recording

Sample Questions

property_ownership: Do you own your home? [Checkbox] OWN [Checkbox] RENT

electric_utility: Who is your electric utility provider? [Open text]

Submitting Your Form

Submit using the “POST” method to the following URL: https://receiver.ceeleads.info/leads/submit

To test posting leads:

Use “test” as first name and “tester” as last name. Note, each test needs a unique email to be accepted (e.g. test1@none.com, test2@none.com, etc)

Post Responses

SERVER_ERROR - Server Error - try again later

POST_REJECT_INVALID_CAMPAIGN - campid missing or invalid

POST_REJECT_DUPLICATE - Lead post string is duplicative

POST_REJECT_DUPLICATE_INFO - Lead contact information already exists in system

POST_REJECT_NON_COMPLIANT - Lead has non-compliant or missing LeadiD/PageID

POST_REJECT_CRITERIA_NOT_MET - Lead parameters do not meet contract criteria

POST_REJECT_ZERO_PAYOUT - Payout is zero based on lead information

POST_VALID - Lead accepted

Post Example

Post Request:

campid=ABC123&ip_address=192.168.100.100&first_name=TEST&last_name=TESTER&street=123+main+st&city=Chicago&state=IL&zip=92660&email=johndoe@mail.com&phone_home=9493667745&property_ownership=OWN

Post Response:

{ "leadId": "0968B3CC", "status": "POST_VALID" }

The above response indicates a valid post. The CEE lead ID is included.

Example of a post missing a valid campid:

{ "leadId": null, "status": "INVALID_CAMPAIGN" }

Example of a rejected post (lead was undesirable):

{ "leadId": null, "status": "POST_REJECT" }