Skip to content

How to Find the Meta Lead ID

Updated: Mar 27, 2025

The lead_id is a mandatory field used in the Conversion Leads CRM integration which uploads events back to Meta to help optimize for higher quality leads, as detailed in the payload specification. It is a unique 15-17 digit number assigned to leads generated on Meta and may be presented in different fields depending on how you download the lead. This section will provide some examples of where the Meta Lead ID may be located for common lead download methods, so you can store it in your CRM and later use it to upload events back to Meta.

The Meta Lead ID must be mapped to a field in your CRM before you can use it to upload events back to Meta.

Webhook or Graph API bulk read

The Meta Lead ID is stored in the id field of the lead node if you download leads using a Webhook or the Graph API.

Graph API lead node JSON response with the id field highlighted

You may also obtain the Meta Lead ID from the leadgen_id field in the leadgen Webhook response.

Leadgen webhook payload array with the leadgen_id values highlighted

Refer to the Webhooks CRM Integration guide and Bulk Read developers guide for more information on these integrations.

Partner integrations

Zapier

The Meta Lead ID will be stored in the id field when downloading leads using Zapier's Facebook Lead Ads trigger app. You will be able to see the Meta Lead ID first in a test trigger where Zapier pulls in a lead from Meta.

Zapier Facebook Lead Ads test trigger result with the id field highlighted

In the Zapier action app, store the Meta Lead ID by mapping it to the standard Lead ID field in your CRM or a custom field if it does not exist.

Zapier Create Record in Salesforce action mapping lead_id to a Lead object

LeadsBridge

The Meta Lead ID will be stored in the id field when downloading leads using LeadsBridge's Facebook Lead Ads app. In the Fields Mapping section, store the Meta Lead ID by mapping it to the standard Lead ID field in your CRM or a custom field if it does not exist.

LeadsBridge Facebook to Salesforce field mapping with Lead ID mapped to id

Make (Integromat)

The Meta Lead ID will be stored in the Lead ID field when downloading leads using Make's Facebook Lead Ads scenario. In the Properties section, store the Meta Lead ID by mapping it to the standard Lead ID field in your CRM or a custom field if it does not exist.

Make CRM module mapping panel with Lead ID selected from Facebook Lead Ads fields

Direct CRM integrations

Salesforce - Leads Capture

The Meta Lead ID will be stored in the Lead ID field when downloading leads using the Salesforce Advertising Studio's Lead Capture feature⁠. In the Configure Fields section, store the Meta Lead ID by mapping it to a custom field you created for it.

Salesforce Lead Capture Configure Fields screen mapping Lead ID to lead_id

Hubspot - Lead Sync

Hubspot's Lead Sync⁠ integration does not store the Meta Lead ID. Download your leads using a Webhook or a partner integration so that you can upload events for Conversion Leads. Alternatively, you can sync your events using Hubspot's Lifecycle Stage Sync⁠ (Professional and Enterprise only).

Zoho CRM - Social

Zoho CRM's Social integration⁠ does not store the Meta Lead ID. Download your leads using a Webhook or a partner integration so that you can upload events for Conversion Leads.

Microsoft Dynamics 365

Microsoft Dynamics 365 does not support a leads integration. Download your leads using a Webhook or a partner integration so that you can upload events for Conversion Leads.

Manual file download

The Meta Lead ID will be the first column of the file labeled id in the .csv file when you manually download your leads from Ads Manager or Business Suite. You may need to strip the leading label before using it as a match key.

Downloaded leads spreadsheet showing id in the first column with created_time and ad_id

Note: This method of downloading leads is not recommended for use in integrations.

Unofficial mirror for reference/search purposes. All content originates from developers.facebook.com — see the source link at the top of each page. Machine-readable indexes: llms.txt · llms-full.txt · About