How to Find the Meta Lead ID

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-16 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.

Webhook or Graph API bulk read

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

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

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 this first in a test trigger where Zapier pulls in a lead from Meta.

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.

Leadsbridge

The Meta Lead ID will be stored in the id field when downloading leads using Leadbridge'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.

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.

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.

Hubspot - Lead Sync

Hubspot’s Lead Sync integration does not store the Meta Lead ID. Please 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. Please 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. Please 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.

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