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

# LinkedIn Lead Gen Forms

> Send LinkedIn Lead Gen Form responses to a Kerux campaign through Zapier and a Kerux form URL, with the member's profile URL.

> [!NOTE]
>
> **Pro plan.** Form URLs, trigger URLs and the **Lead form submitted** trigger are part of Pro and Agency (and the free trial). Anything you already have keeps working on every plan. See [Plans and billing](/help/account/billing.md).

Someone fills in the form on your LinkedIn ad. Zapier sends the response to a secret Kerux form URL, the person becomes a contact and starts your campaign: a connection request and a personal message from your account. Kerux doesn't run your ads; it follows up with the people who answered.

> [!NOTE]
>
> **How it connects:** Kerux has no direct LinkedIn Lead Gen Forms connection yet, so Zapier sits in between: Zapier's LinkedIn Lead Gen Forms app (trigger **New Form Response**) and **Webhooks by Zapier**, sending to a Kerux form URL for **Other form tool**. LinkedIn lists **LinkedIn Profile URL** among the profile fields a Lead Gen Form can pre-fill ([Lead Gen Forms specs](https://business.linkedin.com/advertise/ads/sponsored-content/lead-gen-ads/specs)). The field names in Zapier come from your form; map them on the first test.

## Before you start

* **LinkedIn:** a Campaign Manager ad account with a Lead Gen Form.
* **Zapier plan:** **Webhooks by Zapier** needs a paid Zapier plan.

## 1. Add the profile URL to the form

In Campaign Manager, edit the form and add **LinkedIn Profile URL** next to first name, last name, email and company. Kerux needs the profile to send a connection request. People without it still come in by their email, but their LinkedIn steps wait in **Home > Tasks** (*missing LinkedIn URL*) until someone adds the profile.

## 2. Make a form URL in Kerux

Go to **Integrations > Connections**. In **Forms**, click **Connect** on the **Other form tool** row. Under **Name your first URL**, type a name (for example *LinkedIn ads*), click **Create URL**, then **Copy**. Keep it private: anyone with this URL can add contacts to your workspace.

## 3. Build the Zap

**1. Trigger**

**LinkedIn Lead Gen Forms > New Form Response**. Connect your LinkedIn account, pick the ad account and the form, and load a test response.

**2. Action**

**Webhooks by Zapier > POST**. **URL:** your Kerux form URL. **Payload Type:** json.

**3. Data**

Clear names help Kerux place each answer: `linkedin_url` from the profile URL field, `first_name`, `last_name`, `email`, `company`, `job_title`, `form_name` with the form's name, and `submission_id` with the response's id, so a retry isn't added twice. Every other field becomes a custom field.

What Kerux receives:

```json theme={null}
{
  "submission_id": "lgf_1001",
  "form_name": "Benchmark report",
  "linkedin_url": "https://www.linkedin.com/in/maria-lopez-example",
  "first_name": "Maria",
  "last_name": "Lopez",
  "email": "maria@example.com",
  "company": "Acme",
  "job_title": "Head of Sales"
}
```

Check where these fields go on your first test in step 4.

## 4. Check where each field goes

Click **Test** on the Zap's action step. In Kerux, the URL's card stops saying **Waiting for your first submission...** and shows **Where each field goes**. Check that the profile URL goes to **LinkedIn profile** and click **Save mapping**.

## 5. Start the campaign

In your campaign's **Triggers** tab, click **+ Add** > **Lead form submitted**, pick **Other form tool** under **Source** and click **Add the trigger**. Someone who is already a contact (same LinkedIn profile or email) is updated, not added again.

Mention what they asked for in the invitation note, for example `Thanks for grabbing the benchmark report, {{contact.first_name}}`.

## Already using a trigger URL?

A Zap that sends responses to a campaign's trigger URL (**Incoming webhook (API)**) keeps working. A trigger URL needs `linkedin_url` in every response; the form URL doesn't, and lets you choose where each field goes in Kerux.

## Test with one contact

Click **Test** on the Zap's action step, then check that the URL's card counts the submission and the person appears in the campaign's contacts.

## Common errors

> [accordion] The contact came in but LinkedIn steps wait
>
> The profile URL wasn't sent, or it went to another field. Add **LinkedIn Profile URL** to the form, map it as `linkedin_url` in the Zap, and check **Where each field goes**.

> [accordion] The Zap doesn't trigger
>
> LinkedIn sends responses to Zapier for the form you picked only. Check the ad account and form in the trigger.

> [accordion] 401 INVALID\_SECRET
>
> The URL in the Zap is wrong, was replaced by **Make a new URL**, or was turned off. Copy it again from Kerux.

Related: [Lead forms from any form tool](/help/integrations/forms/lead-forms.md), [Zapier](/help/integration-guides/zapier.md), [Facebook and Instagram lead ads](/help/integrations/facebook-lead-ads.md), [Make](/help/integration-guides/make.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.