> ## 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 Phonexa Integration

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

> Connect Phonexa to your landing pages in LanderLab to send lead data directly to your Phonexa campaigns in real time. All you need is your Publisher API credentials from the Phonexa platform.

## What is Phonexa?

Phonexa is an all-in-one performance marketing platform used by lead generators, publishers, and advertisers to manage lead distribution, call tracking, email marketing, and more. Its LMS Sync product handles lead posting, allowing publishers to send leads via HTTP POST to Phonexa campaigns in real time.

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

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

***

## How to Add Phonexa

The Phonexa 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 Phonexa integration.
  </Step>

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

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

  <Step title="Fill in the connection details">
    Enter the following details:

    | Field            | Description                                                                                                                           |
    | :--------------- | :------------------------------------------------------------------------------------------------------------------------------------ |
    | **Name**         | A label to identify this integration (e.g. "Phonexa - Auto Loans"). This helps you recognize it in the integrations list.             |
    | **API URL**      | The posting endpoint URL for your Phonexa product (e.g. `api.phonexa.com/...`). This is provided in your Phonexa Publisher API specs. |
    | **API ID**       | Your numeric Publisher API ID (e.g. `12345`). This is the unique identifier assigned to your publisher account in Phonexa.            |
    | **API Password** | The API password associated with your Publisher API ID. This is set and managed inside Phonexa.                                       |

    <Tip>
      To find your **API URL**, **API ID**, and **API Password**, log in to your Phonexa account and go to **LMS Sync**, then open **Publisher Products API**. Select the product you want to post leads to. The posting URL, API ID, and API Password are all listed in the Lead Specs section of your API documentation. You can also find them under your publisher profile in the API Access settings.
    </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 Phonexa.

<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 Phonexa 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. Edit the **Sent As** value to match the field names in your Phonexa API specs.

    <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 Phonexa API specs exactly. Phonexa will reject leads that include fields in the wrong format or with missing required values.
    </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, traffic source identifiers, or any custom parameter your Phonexa 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 Phonexa integration">
    The final step shows a complete summary of what will be sent to Phonexa for every lead. You will see:

    * The **posting type** and integration name
    * The **configuration** section showing your API URL, API ID, and API Password
    * 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 Phonexa campaign expects. If anything looks off, click **Back** to return to the previous steps.
  </Step>

  <Step title="Click Connect Phonexa">
    If everything looks correct, click the **Connect Phonexa** button to save and activate the integration.
  </Step>
</Steps>

***

## Where to Find Your Phonexa API Credentials

If you are not sure where to find your API URL, API ID, and API Password, follow these steps:

1. Log in to your [Phonexa](https://app.phonexa.com) account.
2. Go to **LMS Sync** in the left sidebar.
3. Click **Publisher Products API**.
4. Select the product you want to connect to.
5. In the **Lead Specs** section, you will find the **posting URL** (your API URL), **API ID**, and **API Password**.

You can also find your API ID and API Password under your publisher profile in the **API Access** settings. Click the **Show** button next to the API Password field to reveal the value.

<Warning>
  If you change or reset your API Password inside Phonexa, the old password will stop working. Make sure to update the password in LanderLab if you reset it.
</Warning>

***

## Tips for Phonexa Integration

* **Match field names exactly** - Phonexa validates all incoming fields against your product's API specs. Use the **Sent As** column in Step 2 to rename fields to match the field names in your Phonexa documentation exactly.
* **Check required fields** - Your Phonexa product's API specs will clearly mark which fields are required. Leads that are missing required fields or contain values in the wrong format will be rejected.
* **Use test mode during setup** - Phonexa supports a test mode by adding `testMode=1` to the payload. You can use the **Additional fields** section in Step 2 to add this as a static key-value pair while testing. Remove it before going live.