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 Sunrun. Otherwise, the lead was not accepted by Sunrun and may be distributed else where.

Post URL

https://leads.sunruntransit.com/leads/submit

Post Fields

Field Name

Data Format

Size

Description

Static Fields

campid

[provided by Sunrun]

-

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?

electric_bill

$0-50
$51-100
$101-150
$151-200
$201-300
$301-400
$401-500
$501-600
$601-700
$701-800
$801+

20

Average Monthly Electric Bill for residential

electricUtilityProviderText

[text]

Unlimited

Name of Electric Utility Company

roof_shade

No Shade
A Little Shade
A Lot Of Shade
Uncertain

30

Approximate shading of roof

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

Submitting Your Form

Submit using the POST method (Content-Type: application/x-www-form-urlencoded) to the following URL: https://leads.sunruntransit.com/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_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&electric_bill=$151-200&roof_shade=No%20Shade&property_ownership=OWN

Post Response:

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

The above response indicates a valid post. The 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" }