Lead Prosper Direct Post Setup

This article will walk you through a Lead Prosper direct post buyer set up. To watch a tutorial on this topic click here

To set up a campaign successfully you'll need your buyer's API specs. Here we have an example of Lead Prosper API specs for a solar campaign (https://example.leadprosper.tech/leadprosper-direct-post). Here you’ll see the Field Name, the Type and Format, whether or not it’s required, and a description of the field

The description will contain what information must be sent, for example a specific value as you see here for lp_key, or a list of allowed values for one of the multiple choice fields

Edit your buyer to start your set up

If you go to the “Ingesting Leads” section on your API specs, you’ll see that the Method for the HTTP is POST. You’ll begin your buyer setup by copying and pasting the Post URL from your API specs and selecting the correct Request Method and Payload Type

The Ingesting Leads section of the API specs also contain an example of the payload

The first 3 static values laid out API specs, lp_campaign_id, lp_supplier_id, and lp_key are unique to every Lead Prosper campaign and will need to be hardcoded into every payload

Since these are Lead Prosper API specs, be sure to add the field lp_action test, so when you test your buyer the Lead Prosper system knows this is a test lead. You will remove this later after receiving a successful test response and before taking the campaign live

You’ll then map the rest of the fields from the API specs to the payload, for example the first name field will map to the green first name campaign shortcode

Although most of our field names match here, they do not need to match exactly, as they can be field mapped - as we see here, monthly electric bill is mapped to utility bill and property type is mapped to home type

You can also add transformers to your fields. If you want to learn more about transformers click the link above the payload builder here

Content-Type is the only header per the API specs. This is automatically filled out here based on the payload type selected above

At the bottom, we have our response mapping. This tells the Lead Prosper system whether the lead was Accepted or logged as a Duplicate. From the API specs you see that for an Accepted response the key on the left hand side is status and the value is ACCEPTED. Below we also see the key and status for Duplicated responses which are status and DUPLICATED

To Test, click Save then click Test buyer

Click on Send request

Once you get an Accepted lead, you can “copy all” in the top right corner and send the data to your buyer. Once they’ve confirmed everything looks good, set your buyer to “live”

Don't forget to remove lp_action "test" from the payload builder before taking the campaign live

If you have any questions please email us at support@leadprosper.io