Loading

Troubleshooting Common Issues with LinkedIn Lead Gen Forms Integration

Date de publication: Apr 30, 2026
Description

Overview

LinkedIn Lead Gen Forms is a feature very much similar to the Web to Lead feature, where the end user submits the form with the details asked on form and a new Lead record is created on successful submission of the form 

In Web-to-Lead, the scratch form is sourced by the Salesforce and you are free to use the form in any form of website where they want to host the form 

In LinkedIn Lead Gen the Lead gen forms are hosted on the LinkedIn in the form of ads which appear to the LinkedIn users in their LinkedIn feed. 

From the LinkedIn side the Ads are hosted/created on the Campaign Manager, where you have an Ad Account under which the you create a Campaign Group, which has campaigns and in each campaign there will be the Lead Gen forms. 

The Lead Gen Form is what would look similar to our Web-to-Lead form interface, where the user chooses the questions that they would like to gather from their target audience. 

In this form, Name, Email are by default gathered and you can add other field data that they would like to gather from the audience of the ad 

So, the gathered data in LinkedIn needs to be mapped in Salesforce like First Name, Last Name more details on how the data needs to be mapped can be found on the below article Generate Leads from LinkedIn Lead Gen Ads

After all this setup is done, most of the customers complain that the leads are not coming into Salesforce but are able to see the Leads in the LinkedIn Side.

Résolution

Please check the below troubleshooting steps that can help you find the cause of the issue

Web-to-Lead 

  • For the LinkedIn Leads to work Web-to-Lead needs to enabled even you are not going to use the feature, if this not enabled , make sure the settings are enabled 

Authentication Issues

  • After December 16, 2024, "Use LinkedIn Lead Sync APIs with Lead Forms" under Lead Settings is needed for the LinkedIn Lead Gen to create Leads in Salesforce. If you find that the setting is not enabled, disconnect the connection by clicking "Delete" next to connected account on the LinkedIn Accounts page, enable this setting and then reconnect the platforms

Ad Accounts not Authorized 

  • You can have more than one ad account connected to their Campaign Manager in the LinkedIn Account, sometimes all the ad accounts show not authorised, sometimes a few show authorised and few show not authorised. For the leads to generate properly they need be authorised always.
  • There could be multiple reasons for the accounts to become not authorised in Salesforce like you have connected the same Account in multiple salesforce orgs, the org might have migrated to Hyperforce, if you are testing it in Sandbox, sandbox refresh can also cause this.
  • In any of the cases or in most of the cases, reconnecting the platforms resolves the issue. 
  • Most customers when asked to reconnect delete the connection in Salesforce and reconnect it again. However, this is not sufficient as this just reinitiates the connection from one end and not both ends. We need to disconnect from LinkedIn side as well.
  • In order to disconnect from the LinkedIn side, the user needs to have access to the Campaign Manager (LinkedIn account) which is connected to Salesforce. 
    A user with access, should navigate to the LinkedIn profile connected to Campaign Manager -> Click the 'Me' icon -> Click Settings & Privacy -> Click 'Data Privacy' -> Look for 'Manage Permitted Services' click on it -> In this page look for 'Lead Gen Product with Salesforce Icon', click 'Remove' next to it. This disconnects the connection from LinkedIn side as well. 
  • Once the connection is disconnected from both ends, we go back to Salesforce and connect the platforms again. 
  • This steps resolve the Not authorised ad accounts issue. If this doesn't solve the issue, please reach out to the Salesforce Support for further assistance 

Leads were coming into Salesforce before but now 

  • Check if Default Lead Creator user's email address has received any email , with the subject "Salesforce Couldn't create this Lead", if there is no email received, check the user email is an actual email and is "Verified" on the user detail page. This email contains the reason why the lead was not created along with the mapped data for the lead 
  • Check if there are any Duplicate Rules, Validation Rules in place in the Org and make sure the leads are matching the needed requirements of the rules set 
  • Check if the mappings of the Leads are mapped correct, that is the data type of the fields are right
  • We can also set the debug logs to see the reason why the lead was not created. 
  • Reconnect the connection between the LinkedIn and Salesforce which also resolves the issue in some cases.

Hidden fields on the LinkedIn not coming as expected

  • For Each hidden field to be mapped in Salesforce, we need to create 2 fields one for the name and other for value 
  • The name field for LinkedIn and the value field will get the actual data that captured from LinkedIn 
  • The first field in alphabetical order is always written to the first mapped field, and so on. Map the LinkedIn hidden fields to your Salesforce fields in alphabetical order.
Numéro d’article de la base de connaissances

005316728

 
Chargement
Salesforce Help | Article