LinkedIn Lead Gen Forms: How to Create One, Which Fields to Use, and a Script to Back Up Your Leads
LinkedIn lead gen forms open inside the ad, filled in from the member's profile, and cost nothing beyond the ad itself. Here is the setup in Campaign Manager as LinkedIn documents it today, the settings we would choose, and a tested script that saves every lead to a CSV file before LinkedIn's one-year limit.
LinkedIn lead gen forms are forms that open inside a LinkedIn ad, prefilled from the member's profile, and LinkedIn charges nothing for them beyond the ad's own cost per click or per impression.
To create one, go to Campaign Manager, click Content & Assets, select Lead generation forms and click Create form; LinkedIn requires a privacy policy URL before it approves the form.
A form can hold up to 12 fields, including up to three custom questions, but LinkedIn's own best practice is three to four fields.
Hidden fields such as CAMPAIGN_NAME and AD_NAME must be added before the form is attached to an active ad set, so add them when you create it.
LinkedIn says collected member profile data can be stored for only one year, so connect a CRM or back up your leads regularly; our script saves them to CSV through the Lead Sync API.
LinkedIn lead gen forms are forms that open inside a LinkedIn ad when someone clicks its button, already filled in with the name, email, job title and company from their LinkedIn profile. The member checks the details and submits without leaving LinkedIn, and the lead lands in Campaign Manager or your CRM. LinkedIn says there is "no additional cost" for the forms beyond the ad itself.
This guide follows LinkedIn's Help Center as we read it on Nov. 18, 2026: how to build a form, which fields and settings we would use, how to get leads out, and a script we wrote and tested that saves every lead in an ad account to a CSV file. The forms work in every country where LinkedIn sells ads; what you may do with the data depends on the privacy law where your leads live, which we come to below.
What are LinkedIn lead gen forms?
A lead gen form is a reusable template in your ad account. You attach it to ads in an ad set with the lead generation objective. LinkedIn's specifications page lists the ad formats that can carry one: single image, carousel, video, event, message, document and conversation ads.
When a member opens the form, LinkedIn fills each field from their profile. Some fields stay editable: work and personal email, work and personal phone, gender, and anything missing from the profile. Gender is never prefilled.
Lead gen forms for LinkedIn Pages and Showcase Pages, the free kind that sat on a company Page, are gone: LinkedIn's API docs say they "are no longer available," though existing ones keep working. Everything in this guide is the ads version in Campaign Manager.
How much do LinkedIn lead gen forms cost?
The form itself is free. You pay for the ad it sits in. LinkedIn's best practices page says these ads are bought on a cost per click or cost per impression basis and that "cost-per-lead is not available at this time." Campaign Manager still reports cost per lead, so you can compare it with other channels after the fact.
How to create a lead gen form on LinkedIn
You need the campaign manager or account manager role on the ad account to create or edit a form. The steps, from LinkedIn's "Create Lead Gen Forms in Campaign Manager" page:
Go to your ad account in Campaign Manager.
Click Content & Assets in the left menu and select Lead generation forms.
Click Create form at the top.
Fill in the sections:
Form details: form name, language, and the headline (up to 60 characters) and details (up to 160) that members see when the form opens.
Lead details: the profile fields to collect, plus up to three custom questions.
Data privacy: a privacy policy URL. LinkedIn requires it for approval.
Confirmation: a thank-you message of up to 300 characters, with an optional landing page link or an appointment booking link (LinkedIn names Calendly and Chili Piper).
Settings: hidden fields for tracking, and the field names used when you download or sync leads.
Click Create.
You can also build a form while setting up a lead generation ad set. LinkedIn's tip: the form's status may need to be Active before it can be reviewed with your ads.
Two things you can't change later. The form language is fixed once saved. And once a form is attached to an ad in an active ad set, only some fields stay editable (headline, details, privacy policy, confirmation message, landing page, the thank-you button and work email validation for Sponsored Content), and every edit sends the form back to ad review, during which LinkedIn says its ads "may stop serving."
LinkedIn lead gen form specs
The numbers from LinkedIn's specifications and fields pages:
Setting
Limit
Fields per form
Up to 12, counting custom questions; first name, last name and email are selected by default
Custom questions
Up to 3, 100 characters each, always required, multiple choice or single line text
Disclosure checkboxes
Up to 5, 500 characters each, not counted toward the 12
Hidden fields
Up to 20, field name up to 250 characters
Form image
552 by 200 pixels recommended; otherwise the ad image or the Page image
Headline / details / thank-you message
60 / 160 / 300 characters
Privacy policy text
Up to 2,000 characters
Language
English forms work with ad sets in any language except simplified Chinese; other languages must match the ad set
Which fields to use: our view
LinkedIn's best practices page recommends three to four fields, and we agree. The form is easy to submit because it is prefilled; every extra field is one more thing the member has to check. Our default for a business-to-business offer:
First name, last name, work email, company name. Turn on Validate work email, which blocks the most common free email domains such as Gmail, Yahoo and Hotmail. LinkedIn says it doesn't block every free domain.
One multiple choice question that sorts leads for sales, such as team size or timeline. Custom questions are required fields, so keep it to one.
Dynamic hidden fields for CAMPAIGN_NAME and AD_NAME. They put the campaign and ad behind each lead into the download and your CRM without building a form per campaign. Add them when you create the form: LinkedIn says hidden fields "can't be added to an existing form that's attached to an active ad set."
Disclosure checkboxes for any use beyond answering the request, such as a newsletter. In the EU, UK and other places with consent rules, this is where you ask for that consent.
On the thank-you screen, say when and how you will follow up, and if you promised a guide or report, link to it there. LinkedIn says it "doesn't automatically send any assets to members."
How to download your LinkedIn leads
You need viewer access or higher on the ad account and the Lead Gen Forms manager role or higher on the company Page. Then:
In Campaign Manager, click Content & Assets, then Lead generation forms.
Tick one or more forms.
Pick a start and end date in the time range menu.
Click Download leads, then Download. Each form downloads as its own CSV file.
You can also export by ad set from Advertise, the Ad Sets tab, Export, with Leads as the report type. If names with accents or non-Latin characters come out garbled, LinkedIn's fix is to import the file into Excel as UTF-8 or open it in Google Sheets.
The part to plan for: LinkedIn's download page says "collected member profile data can only be stored for one year because of our member privacy policy," while the performance numbers stay in Campaign Manager. Don't treat Campaign Manager as your lead archive. Connect your CRM or marketing automation tool (LinkedIn lists supported partners in its Marketing Partner Directory), or keep your own copy.
Our script: back up every lead to CSV
For accounts with access to LinkedIn's Lead Sync API, we wrote a short Node.js script that pulls every form and every lead in an ad account and writes one CSV, with readable column names and multiple choice answers turned back into their text. It leaves test leads out unless you add --test.
Access is the catch. LinkedIn says Lead Sync "is a separate program," and access to the Advertising API "does not automatically grant access." You need an app approved for the r_marketing_leadgen_automation permission and a token from a person with ad account access and a Page role such as Lead Gen Forms manager. If you use a CRM integration, your vendor already has this; the script is for teams that want their own copy.
// linkedin-leads.mjs: save every LinkedIn Lead Gen Form lead in an ad account to CSV.// Needs Node 18+ and an access token with the r_marketing_leadgen_automation scope// (LinkedIn's Lead Sync API, which LinkedIn approves separately from the Advertising API).// Usage: LINKEDIN_TOKEN=... node linkedin-leads.mjs <adAccountId> [--test] > leads.csvconst [account, flag] = process.argv.slice(2);const TOKEN = process.env.LINKEDIN_TOKEN;const VERSION = process.env.LINKEDIN_VERSION || '202611'; // YYYYMM; LinkedIn retires old versionsif (!account || !TOKEN) { console.error('Usage: LINKEDIN_TOKEN=... node linkedin-leads.mjs <adAccountId> [--test]'); process.exit(1);}const owner = `(sponsoredAccount:${encodeURIComponent(`urn:li:sponsoredAccount:${account}`)})`;async function getAll(path, query) { const out = []; for (let start = 0; ; start += 50) { const url = `https://api.linkedin.com/rest/${path}?q=owner&owner=${owner}${query}&count=50&start=${start}`; const res = await fetch(url, { headers: { Authorization: `Bearer ${TOKEN}`, 'LinkedIn-Version': VERSION, 'X-Restli-Protocol-Version': '2.0.0', }, }); if (!res.ok) throw new Error(`${path}: HTTP ${res.status} ${await res.text()}`); const { elements = [] } = await res.json(); out.push(...elements); if (elements.length < 50) return out; }}const text = (m) => (m?.localized ? Object.values(m.localized)[0] : '');// 1. Forms: question and option labels, keyed by form id.const forms = new Map();for (const f of await getAll('leadForms', '')) { const questions = new Map(); for (const q of f.content?.questions || []) { const options = new Map( (q.questionDetails?.multipleChoiceQuestionDetails?.options || []).map((o) => [o.id, text(o.text)]) ); questions.set(q.questionId, { label: q.predefinedField || text(q.question) || q.name, options }); } forms.set(String(f.id), { name: f.name, questions });}// 2. Leads, newest last, with test leads left out unless --test.const leads = (await getAll('leadFormResponses', '&leadType=(leadType:SPONSORED)')) .filter((l) => flag === '--test' || !l.testLead) .sort((a, b) => a.submittedAt - b.submittedAt);const columns = ['submitted_utc', 'form', 'campaign', 'lead_id', 'test_lead'];const rows = leads.map((l) => { const formId = (l.versionedLeadGenFormUrn || '').match(/leadGenForm:(\d+)/)?.[1]; const form = forms.get(formId) || { name: `form ${formId}`, questions: new Map() }; const row = { submitted_utc: new Date(l.submittedAt).toISOString(), form: form.name, campaign: l.leadMetadataInfo?.sponsoredLeadMetadataInfo?.campaign?.name || '', lead_id: l.id, test_lead: l.testLead ? 'yes' : '', }; for (const a of l.formResponse?.answers || []) { const q = form.questions.get(a.questionId) || { label: `question ${a.questionId}`, options: new Map() }; const d = a.answerDetails || {}; row[q.label] = d.textQuestionAnswer ? d.textQuestionAnswer.answer : (d.multipleChoiceAnswer?.options || []).map((id) => q.options.get(id) ?? id).join('; '); if (!columns.includes(q.label)) columns.push(q.label); } return row;});const cell = (v = '') => (/[",\n]/.test(String(v)) ? `"${String(v).replace(/"/g, '""')}"` : String(v));console.log(columns.map(cell).join(','));for (const r of rows) console.log(columns.map((c) => cell(r[c])).join(','));console.error(`${rows.length} leads from ${forms.size} forms`);
How we tested it. We have no Lead Sync access of our own, so we ran the script against a stand-in for api.linkedin.com built from the sample requests and responses in LinkedIn's Lead Sync documentation (version 2026-11): one form with a first name, email and multiple choice question, and 60 leads, one of them a test lead. The script sent the documented headers and Rest.li-encoded owner parameter, read both pages of leads, wrote 59 rows (the test lead left out, 60 with --test), turned option ids into their labels, and kept commas and quotes inside answers intact. Run it once with a real token and compare the row count with a Campaign Manager download before you rely on it.
Lead gen form or landing page?
Our view: test both, and judge them on what happens after the lead. A prefilled form takes a few taps to submit, so it can bring more leads at a lower cost per lead than a page on your site, but the number that matters is how many become sales conversations. LinkedIn's own FAQ suggests the test: run a Sponsored Content ad set that sends people to your landing page, with conversion tracking, alongside a lead gen form ad set, then compare cost per conversion with cost per lead. Add your CRM's view of lead quality to that comparison, and use the CAMPAIGN_NAME hidden field so you can tell the two apart.
If you also run the form on single image ads, LinkedIn notes a quirk: on mobile, a tap on the intro text opens the form, while on desktop a click on the same text goes to your landing page, if the copy includes one.
What we don't know
How long leads stay downloadable in Campaign Manager itself. LinkedIn's page says member data can be stored for one year; it doesn't say whether the download button stops returning older leads sooner.
The largest page size the Lead Sync API accepts. The docs don't state one; our script asks for 50 at a time.
The exact format of the API's submittedAtTimeRange filter. The docs say it takes epoch times but give no example, so our script fetches all leads rather than a date range.
Kiran runs Kihan Marketing, a web design, SEO and ads agency, and manages dozens of websites across real estate, home services and healthcare. He writes about SEO, AI search and paid ads news, and what it means for the people who run websites.