Documentation
LinkedIn Lead Gen Integration
Import leads from your LinkedIn ad campaigns automatically. When someone fills out a Lead Gen Form on LinkedIn, the lead appears in LeadMachine within seconds.
What You Need
- LeadMachine account with Admin role
- A LinkedIn Ad Account in Campaign Manager
- At least one Lead Gen Form campaign (active or planned)
Connect Your LinkedIn Ad Account
Step 1: Open the integration page
- Click your profile in the top-right corner
- Select Integrations
- Click the LinkedIn card
Step 2: Start the connection
Click Connect LinkedIn. You'll be redirected to LinkedIn.
Step 3: Authorize on LinkedIn
- Log in to LinkedIn if prompted
- Review the permissions and click Allow
LinkedIn will redirect you back to LeadMachine.
Step 4: Pick your ad account
You'll see a list of your LinkedIn Ad Accounts. Select the one running your Lead Gen campaigns and click Save Connection.
That's it. LeadMachine will:
- Fetch all your existing Lead Gen Forms and enable them for sync
- Register a real-time webhook so new leads are delivered instantly
- Start receiving leads from every form on that account
- Automatically enrich and score every incoming lead (see below)
How Leads Arrive
There are two ways leads come in:
Real-time (automatic) -- LinkedIn sends a webhook the moment someone submits your form. LeadMachine fetches the full lead data and creates a lead within seconds. No action needed from you.
Manual sync -- Click the Sync Now button on the LinkedIn integration page to pull any leads that may have been missed. This also auto-discovers any new forms you've created since connecting.
What Gets Imported
| LinkedIn Field | LeadMachine Field |
| --- | --- |
| First Name | First Name |
| Last Name | Last Name |
| Contact (email) | |
| Phone | Contact (phone) |
| Company | Company |
| Job Title | Title |
- Custom form questions are added as a note on the lead
- Every lead is tagged LeadGen and sourced as LinkedIn Ads
- Duplicate emails are detected and skipped automatically
- Every new lead is automatically queued for enrichment and scoring
Managing Your Forms
Your Lead Gen Forms are listed on the integration page. Each form shows:
- Form name and numeric ID
- Status from LinkedIn
- Leads synced count
- Sync toggle to enable/disable that form
You can turn off specific forms if you don't want their leads imported.
New forms are auto-discovered
When you create a new Lead Gen Form in Campaign Manager, you don't need to do anything. LeadMachine will automatically detect and register unknown forms when:
- A lead arrives from a form that isn't registered yet
- You click Sync Now (refreshes the form list from LinkedIn)
- You click Refresh Forms (pulls the latest form list)
No leads are ever dropped because of a missing form registration.
Webhook Health
The integration page shows the health of your real-time webhook connection:
- Green (Last webhook: Xh/Xd ago) -- Working normally. Shows when the last lead was delivered.
- Amber (Webhook idle) -- No webhook activity in over 7 days. This is normal if you haven't had any form submissions recently, but if you're expecting leads, try re-registering.
- Red (No webhook activity detected) -- The webhook has never received a lead. Click Re-register Webhook to fix.
Re-register Webhook
If your webhook stops working, click the Re-register Webhook button. This deletes the old webhook subscription and creates a new one with LinkedIn. No reconnection or re-authorization needed.
Auto-Enrichment & Lead Scoring
Every lead imported from LinkedIn is automatically queued for enrichment and scoring:
- Enrichment — Hunter.io looks up professional email addresses, Google Places enriches company data (address, phone, website, industry)
- Lead Scoring — After enrichment, an AI score (0-100) is computed based on engagement, data completeness, source quality, and value signals
- Grade Assignment — Leads are graded A (80+), B (60-79), C (40-59), or D (below 40)
- Auto-Tagging — Grade changes trigger automatic tag assignment (
score-tier-a,score-tier-b, etc.) which can enroll leads into nurture campaigns
This happens in the background within minutes of the lead arriving. No manual action needed.
LinkedIn leads receive a source quality score of 5/5 (highest tier), so they start with a scoring advantage.
For more details, see Lead Enrichment and Lead Scoring.
Conversion Tracking (CAPI)
Optionally send conversion events back to LinkedIn to measure your ad ROI.
- Scroll to the Conversions API (CAPI) section on the integration page
- Generate a Direct API Access Token in LinkedIn Campaign Manager (Conversions API > Direct API > Generate token)
- Paste the token and click Save
- Click Add Rule to map CRM events to LinkedIn conversions
Available events: Lead Created, Deal Created, Deal Won, Deal Lost, Lead Qualified.
For detailed CAPI setup, see LinkedIn Conversions API.
Troubleshooting
Can't connect
- Make sure you're an admin on the LinkedIn Ad Account
- Try an incognito/private browser window
- Clear cookies and try again
No ad accounts showing
- You need at least one active Ad Account in Campaign Manager
- Sponsored Job-only accounts aren't supported
- Verify your role in Campaign Manager (Admin or Account Manager required)
No forms showing
- Create a Lead Gen Form in Campaign Manager first
- Click Refresh Forms to pull the latest list
- Forms must belong to the connected ad account
Leads not arriving
- Check that the webhook health indicator is green
- Verify the form's sync toggle is enabled
- Make sure your Lead Gen Form is attached to an active campaign
- Try clicking Sync Now to manually pull recent leads
- If webhook is red/amber, click Re-register Webhook
- Test with a preview lead in Campaign Manager
Token expired
If the connection shows an error:
- Click Disconnect
- Click Connect LinkedIn to reconnect
- Authorize and select your ad account again
- Leads will resume automatically
Disconnecting
Click Disconnect and confirm. This removes the webhook and stops new leads from arriving. Previously synced leads and CAPI rules are preserved. You can reconnect at any time.
Support: [email protected]