leads_retrieval

The leads_retrieval permission allows your app to retrieve and read all information captured by a lead ads form associated with an ad created in Ads Manager or the Marketing API. The allowed usage for this permission is to contact people who completed your lead ad form requesting more information. For example, an auto dealer reaching out to a potential customer (lead) that responded to their ad with quotes for a car. This permission can also be used by advertiser authorized CRM platforms to pull the lead data on behalf of the advertisers. These advertisers can then use the lead information to reach out to the user. Note: Requires the pages_manage_ads, pages_read_engagement, and pages_show_list permissions to work correctly. You may also use this permission to request analytics insights to improve your app and for marketing or advertising purposes, through the use of aggregated and de-identified or anonymized information (provided such data cannot be re-identified).

Allowed Usages

• Reach out to the people who followed up your lead ad form requesting more information. For example, an auto dealer reaching out to a potential customer (lead) that responded to their ad with quotes for a car.
• For advertiser authorized CRM platforms to pull the lead data on behalf of the advertisers. These advertisers can then use the lead information to reach out to the user.

Common Endpoints

/adgroup/leads/
/page/leadgen_forms

Additional Details

• This permission or feature requires successful completion of the App Review process before your app can access live data. Learn More
• This permission or feature is only available with business verification. You may also need to sign additional contracts before your app can access data. Learn More Here