Capture leads in Facebook ads — lead ads provide people with a quick and privacy-safe way to sign up to receive information from your business.
Lead ads make forms simple for people and more valuable for businesses. Set up a lead ad where prospective customers can sign up for what you're offering and you'll get accurate contact information to follow up.
The form is mobile-friendly and uses information people already shared with Facebook. It's easier and faster for people to reach businesses — and advertisers get accurate, actionable information. Learn more about Lead Ads.
To get started with lead ads, you will need:
A Facebook Page — Gives your business a presence on Facebook and helps you connect with customers. See Facebook for Business or create a new page. All leads generated via a lead ad belong to the Facebook Page.
An Instagram Account (optional) — This is required if you want to run a lead ad on Instagram. The leads generated via the ad still belong to the Facebook Page.
A Facebook App — Can be any third-party app, such as a website, mobile app, or script. The Marketing API apps enable integration with Facebook. Each app has an app ID you use whenever you use one of our SDKs or Open Graph tags for sharing. Find your app ID in your App Dashboard. Learn more about how to create an App and app ID.
A Test App (optional) — Quickly create Facebook app IDs for use during development, testing, staging, or QA phases. Test apps have their own app ID and independent settings and are helpful in pre-production. See Test Apps.
App Review — To retrieve lead data, your app must undergo App Review. You must include the
pages_manage_ads permissions in your submission. Check our Submission Guide for details. After approval, you will be asked to complete Business Verification.
Starting in Marketing API v9.0, you will not be able to retrieve leads if your app is in Development mode. For testing purposes, Development mode app users can access leads submitted by someone with a role in that same app. See App Roles.
Apps in Live mode continue to have access to all leads.
An access token is an opaque string that identifies a user, app, or Page and can be used by the app to make Graph API calls. You can obtain access tokens via a number of methods. See the access tokens documentaiton for more information on the different types and how to get them.
Access tokens can be short or long-lived. Short-lived tokens typically have a lifetime of about an hour or two, while long-lived tokens usually have a lifetime of about 60 days. You should not depend on these lifetimes remaining the same as they may change without warning or expire early.
User access tokens are rate-limited based on active users on the app, which is usually ONE for lead ad integrations.
We strongly recommend using Page access tokens because they're rate-limited based on active users on the Page.
With Facebook lead ads, you can set up the leads you receive from Facebook to be instantly updated into your CRM system. Your options include:
HTTP POSTcall. See Lead Ads Webhooks for more information.
To see a better performance in your lead ads, you can choose to share your CRM data about your leads back to Facebook to unlock quality lead optimization. This allows Facebook to better optimize for quality leads by using data on which generated lead turned out to be quality leads from your CRM directly.
Note: Steps 1 and 3 are currently only available via the Events Manager.
See more information about connecting your CRM to the Conversions API in the CRM Integration guide.
To read lead data, you need Page Admin access or flexible permissions. With the latter, you retrieve leads without Page Admin access.