Actions72
- Pages Actions
- Posts Actions
- Groups Actions
- Events Actions
- Insights Actions
- Marketing/Ads Actions
- Videos Actions
- Messaging Actions
- Shop/Catalog Actions
- Lead Ads Actions
- Webhooks Actions
Lead Ads → Get Leads
AI-generatedOverview
The "Get Leads" operation of the "Lead Ads" resource in this Facebook Enhanced node allows users to retrieve lead data collected from a specific Facebook Lead Ad form. This is useful for marketers and sales teams who want to automate the extraction of leads generated via Facebook advertising campaigns directly into their workflows for further processing, such as CRM integration, email marketing, or lead qualification.
Practical examples include:
- Automatically fetching new leads submitted through a Facebook Lead Ad form to add them to a mailing list.
- Periodically retrieving all leads from a particular form to analyze lead quality or follow up.
- Integrating lead data with other systems without manual export/import steps.
Properties
| Name | Meaning |
|---|---|
| Form ID | The unique identifier of the Facebook Lead Ad form from which to retrieve leads. This is required to specify which form's leads to fetch. |
Output
The node outputs an array of JSON objects where each object represents a lead retrieved from the specified Facebook Lead Ad form. Each lead object contains the data fields submitted by the user in the lead form, such as contact information and answers to custom questions.
No binary data output is indicated for this operation.
Dependencies
- Requires a valid API key credential for the external N8N Tools API service used for validation.
- Requires Facebook API credentials (OAuth2 or API key) configured in n8n to authenticate requests to Facebook Graph API.
- The node internally uses a helper class to interact with Facebook's Graph API endpoints related to Lead Ads.
Troubleshooting
- Invalid subscription or API key error: If the node throws an error about invalid subscription or API key, verify that the API key credential for the external N8N Tools API is correctly set and active.
- Facebook API authentication errors: Ensure that the Facebook OAuth2 or API key credentials are valid and have the necessary permissions to access Lead Ads data.
- Missing or incorrect Form ID: The "Form ID" property is required; ensure it is correctly provided and corresponds to an existing Lead Ad form.
- Rate limits or permission issues: Facebook may impose rate limits or require specific permissions; check Facebook developer console and app settings if calls fail.