Connecting LinkedIn Lead Gen Forms
Use OAuth to import LinkedIn Sponsored Content lead forms into LeadToSheet.
Before you start
You need a LinkedIn Campaign Manager account with access to the ad account that runs your lead-gen campaigns.
Note
While LinkedIn Marketing Developer Program approval is pending for the LeadToSheet app, the OAuth flow may be limited to approved accounts. If you see a closed-beta message, use a Custom Webhook source as the fallback.
Connect your account
- 1
Open Sources
In LeadToSheet, open the site you want to receive the leads, then choose Sources in the sidebar.
- 2
Pick LinkedIn Lead Gen Forms
Click Connect on the LinkedIn card. You will be redirected to LinkedIn to authorise.
- 3
Approve scopes
LinkedIn asks for permission to read ad accounts, lead forms, lead responses, and register lead-notification webhooks. LeadToSheet does not publish posts or ads for you.
- 4
Pick an account and forms
After redirect, choose the site, ad account, and lead forms you want to import.
- 5
Optional: backfill history
Enable backfill if you want recent historical leads pulled. AI scoring is off for backfills by default to avoid surprise enrichment cost.
How webhook delivery works
LeadToSheet registers one LinkedIn webhook URL per connection with a per-connection verification parameter. LinkedIn validates the URL during setup and re-validates it on a recurring schedule.
Important
LinkedIn only pushes lead notifications to webhook URLs that pass a periodic validation handshake (enforced since March 16, 2026). LeadToSheet handles the handshake automatically for connected accounts, so no action is required on your end.
When the connection breaks
LinkedIn access tokens last 60 days. LeadToSheet checks hourly and refreshes any connection with under 14 days remaining. There are two failure states you'll see a reconnect action for:
- TOKEN_EXPIRED — the refresh attempt failed (most commonly because the token aged out without an interactive LinkedIn session to revive it).
- SCOPE_REVOKED — you (or another admin) removed LeadToSheet's access in LinkedIn's app permissions. Reconnecting re-grants the r_marketing_leadgen_automation, r_ads, and r_organization_admin scopes.