> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Up Leadprosper Integration

> Learn how to connect Leadprosper to LanderLab to send leads directly to your Leadprosper campaigns in real time from any landing page or quiz funnel.

> Connect LeadProsper to your landing pages in LanderLab to send lead data directly to your LeadProsper campaigns in real time. Choose between Direct Post and Ping-Post depending on your campaign setup.

## What is LeadProsper?

LeadProsper is a lead distribution platform used by lead generators, affiliates, and advertisers to receive, validate, and route leads to buyers in real time. It supports both direct posting (sending leads straight to a campaign) and ping-post workflows (sending partial data first so buyers can bid before receiving the full lead).

When you connect LeadProsper to your landing page in LanderLab, every lead collected on your page is automatically posted to your LeadProsper campaign. LanderLab handles the API connection for you, so you do not need to write custom code or build server-side integrations manually.

<Note>
  LeadProsper integrations are **not** saved globally. Each integration is configured per landing page, so you will need to set up a new LeadProsper connection for each landing page where you want to send leads.
</Note>

***

## Direct Post vs. Ping-Post

LanderLab supports two posting types for LeadProsper. You choose the type during setup based on how your LeadProsper campaign is configured.

**Direct Post** sends the full lead data to LeadProsper in a single request. The lead is then validated and distributed to buyers based on your campaign rules. This is the simpler option and works well when you have a straightforward lead delivery setup.

**Ping-Post** is a two-step process. First, a "ping" is sent with partial lead data (such as zip code or state) so buyers can decide if they want the lead and place a bid. If a bid is accepted, a second "post" is sent with the complete lead information. This method is used when multiple buyers compete for leads in real time.

***

## How to Add LeadProsper

The LeadProsper setup uses a 3-step wizard: configure the connection, map your fields, and review the final payload before connecting.

### Step 1: Configure the Connection

<Steps>
  <Step title="Go to your landing page">
    Navigate to **Landing Pages** and click the **name of the landing page** where you want to add the LeadProsper integration.
  </Step>

  <Step title="Open the Integrations tab">
    Click **Add Integration** to open the integrations panel.
  </Step>

  <Step title="Select LeadProsper integration">
    From the list of available integrations, find **LeadProsper integration** (labeled as "Send leads to LeadProsper in real time") and click on it. The configuration wizard will open.
  </Step>

  <Step title="Fill in the connection details">
    Start by entering a **Name** for this integration (e.g. "LeadProsper - Auto Loans"). Then select the **Type** based on your LeadProsper campaign setup: **Direct Post** or **Ping-Post**.

    Both types require the same three fields:

    | Field              | Description                                                                                      |
    | :----------------- | :----------------------------------------------------------------------------------------------- |
    | **LP Campaign ID** | The numeric Campaign ID for your LeadProsper campaign (e.g. `12345`).                            |
    | **LP Supplier ID** | The numeric Supplier ID assigned to your supplier account in LeadProsper (e.g. `6789`).          |
    | **LP Key**         | The unique key associated with your campaign and supplier. This is generated inside LeadProsper. |

    These three values are unique to every LeadProsper campaign and are required for both Direct Post and Ping-Post setups.

    <Tip>
      To find your **LP Campaign ID**, **LP Supplier ID**, and **LP Key**, open your LeadProsper campaign, go to the **Supplier API Specs** (also called the Posting Guide), and look for the `lp_campaign_id`, `lp_supplier_id`, and `lp_key` values. These are listed as required static fields at the top of the API documentation.
    </Tip>
  </Step>

  <Step title="Click Continue">
    Click **Continue** to move to the field mapping step.
  </Step>
</Steps>

***

### Step 2: Map Your Fields

In this step, you choose which data fields to include in the request and how they should be named when sent to LeadProsper.

<Steps>
  <Step title="Select and configure fields">
    LanderLab automatically includes a set of default LanderLab fields. Each field has a checkbox to include or exclude it, and a **Sent As** column where you can rename the key to match what LeadProsper expects.

    The default LanderLab fields are:

    | Form Field                 | Sent As (default key)    | Description                                          |
    | :------------------------- | :----------------------- | :--------------------------------------------------- |
    | **LL Lander URL**          | `ll_lander_url`          | The full URL of the landing page the visitor was on. |
    | **LL Visitor IP**          | `ll_visitor_ip`          | The IP address of the visitor.                       |
    | **LL Visitor User Agent**  | `ll_visitor_user_agent`  | The browser and device information of the visitor.   |
    | **LL Submission Time UTC** | `ll_submission_time_utc` | The date and time the lead was submitted (in UTC).   |
    | **LL Variant ID**          | `ll_variant_id`          | The A/B test variant ID the visitor was shown.       |

    Use the checkboxes to enable or disable any field. You can also edit the **Sent As** value to match the field names your LeadProsper campaign expects.

    <Tip>
      If your landing page includes a **quiz funnel** or **form**, all the form fields you have added (such as name, email, phone, address, and any custom inputs) will automatically appear in this field list alongside the default LanderLab fields. You can enable, disable, or rename them just like the default fields. Make sure the **Sent As** values match the field names in your LeadProsper API specs exactly, or your leads may be rejected.
    </Tip>
  </Step>

  <Step title="Add custom fields (optional)">
    Under the **Additional fields** section, click **+ Add field** to include extra key-value pairs in the request. This is useful for sending static values like sub IDs, lead source tags, or any custom parameter your LeadProsper campaign requires.
  </Step>

  <Step title="Click Continue">
    Click **Continue** to move to the review step.
  </Step>
</Steps>

***

### Step 3: Review and Connect

<Steps>
  <Step title="Review your LeadProsper integration">
    The final step shows a complete summary of what will be sent to LeadProsper for every lead. You will see:

    * The **posting type** (Direct Post or Ping-Post) and integration name
    * The **configuration** section showing your Campaign ID, Supplier ID, and Key
    * The **field mapping** section listing all fields and their corresponding template variables (e.g. `{{LL Lander URL}}`, `{{LL Visitor IP}}`)

    Review everything carefully to make sure the configuration and field names match what your LeadProsper campaign expects.
  </Step>

  <Step title="Click Connect LeadProsper">
    If everything looks correct, click the **Connect LeadProsper** button to save and activate the integration. If you need to change anything, click **Back** to return to the previous steps.
  </Step>
</Steps>

***

## Where to Find Your LeadProsper Credentials

If you are not sure where to find your Campaign ID, Supplier ID, and Key, follow these steps:

1. Log in to your [LeadProsper](https://app.leadprosper.io) account.
2. Open the campaign you want to connect.
3. Go to the **Supplier API Specs** (also called the Posting Guide). You can access this from the campaign's supplier section.
4. Look for the three required static fields at the top: `lp_campaign_id`, `lp_supplier_id`, and `lp_key`.
5. Copy these values and paste them into the corresponding fields in LanderLab.

<Note>
  Your LeadProsper campaign must have at least one **supplier** and one **buyer** configured before the API specs become available. If you do not see the Posting Guide, make sure both are set up in your campaign.
</Note>

***

## Tips for LeadProsper Integration

* **Match field names exactly** - LeadProsper validates incoming data against your campaign's field definitions. If the field names in LanderLab do not match the field names in your LeadProsper API specs, the lead will be rejected. Use the **Sent As** column in Step 2 to rename fields as needed.
* **Test before going live** - When setting up your LeadProsper campaign, keep your supplier in **Test Mode** until you confirm that leads are being accepted correctly. Test leads are not distributed to buyers and do not incur charges.
* **Check field formats** - LeadProsper has built-in validation for field types and formats (e.g. phone numbers must be 10 digits, emails must be valid). Make sure your form fields collect data in the format your LeadProsper campaign expects.
