1: Connecting Your CRM to Download Leads

This guide helps you connect your customer relationship management (CRM) system and ensure your CRM system is downloading your leads from Meta.

As mentioned in the introduction, this guide assumes that you already have an integration to automatically download your leads from Meta to your CRM system (highlighted in green in the figure below). This section will provide an overview of the Meta to CRM integration methods for Lead Ads. For each of these integration methods, ensure that the 15–17 digit Meta Lead ID is included in the downloaded data. Refer to About CRM System Integrations for Lead Ads⁠ for more information.

Learn how to integrate your CRM with Meta⁠ to optimize the quality of your lead ads. Partner integrations are a good method to download your lead data if your CRM system or third-party vendor is supported. You can check if your preferred partner is supported by searching the Available CRM System Integrations for Lead Ads⁠ help center article.

You can also create a custom Webhooks integration to automatically receive new leads if your CRM system is not supported or you would prefer more control over the integration. This method requires developer resources.

This method requires your developer to create a Webhook endpoint, a Meta developer app ID, and a subscription to your app, then link the app to your Page.

Refer to the Webhooks CRM integration guide for more information on implementing this method. You can also refer to the Lead Ads Webhook code sample⁠ on GitHub to get started.

Similarly as with Webhooks, you can use the Graph API to download leads from Meta. This method requires developer resources.

The main difference between the two integrations is that Webhooks is a push/pull method that can give you leads close to real time, whereas the Graph API bulk read is a pull method that will give you lead data upon a call from your code. There are also rate limits for these API calls.

Refer to the Retrieving Leads: Bulk Read documentation for more information on implementing this method.

This method is not recommended, especially if you have a CRM system and are intending to implement a CRM integration to upload events. However, use this method as a temporary solution if any of the Partner integrations, Webhooks, or Graph API bulk read have issues.