Meta Lead Forms
The Meta Lead Forms block fetches leads collected by your Facebook and Instagram Lead Ads forms on demand — without waiting for a webhook. Use it for scheduled syncs ("pull all new leads every morning") or to look up a single lead by ID.
Pull vs. Push: This block pulls leads whenever the workflow runs. For real-time delivery the moment a lead submits a form, use the Facebook Lead Ads trigger instead — the two work well together.
Meta Lead Forms is not available on the Free plan. Upgrade your workspace plan to use this block.
Key Features
- On-Demand Lead Retrieval: Fetch leads from a specific lead form whenever the workflow runs
- Incremental Sync: A
Sincetimestamp lets you fetch only leads created after your last run - Form Discovery: List all lead forms on a Facebook Page to find their IDs
- Response Mapping: Save lead fields (name, email, custom answers) straight into workflow variables
Operations
| Operation | What it does |
|---|---|
| Get Lead Form Leads | Fetches leads from a selected Facebook Page and Lead Form. Supports a Since timestamp and a result limit |
| Get Single Lead by ID | Fetches one lead when you already have its lead ID (for example from the trigger) |
| Get Page Lead Forms | Lists all lead forms on a Facebook Page, with their IDs — useful for discovering which form to query |
Configuration
| Parameter | Type | Required | Description |
|---|---|---|---|
| Meta Ads Account | Credential | Yes | The Meta Ads connection to use |
| Operation | Select | Yes | One of the three operations above |
| Facebook Page | Select | Get Lead Form Leads / Get Page Lead Forms | The Page whose forms you want to read |
| Lead Form | Select | Get Lead Form Leads | The lead form to fetch leads from |
| Since (ISO timestamp) | Text | No | Only return leads created after this time, e.g. 2026-01-01T00:00:00Z |
| Limit | Number | No | Maximum number of results to return |
| Lead ID | Text | Get Single Lead | The lead's ID (can be a {{variable}}) |
| Response mapping | Field → Variable | No | Save lead fields into workflow variables |
Response mapping fields
Common lead fields you can map to variables:
| Field | Description |
|---|---|
id | The lead's ID |
created_time | When the lead was submitted |
form_id | The lead form's ID |
ad_id / ad_name | The ad that produced the lead |
adset_id / campaign_id | The ad set and campaign IDs |
field_data | The form answers (name, email, phone, custom questions) |
Setting up the credential
The block uses a Meta Ads credential. You can connect in two ways:
Option A — Connect with Facebook (easiest)
- In the block settings, click to add a Meta Ads account.
- Choose Connect with Facebook and log in with an account that manages the Page and its ads.
- Approve the requested permissions.
Option B — System User Token (for long-lived server access)
- In Meta Business Settings, open Users → System Users.
- Create a system user (if needed) and assign it to your Ad Accounts and Pages with admin permissions.
- Click Generate New Token and select the
leads_retrieval,pages_manage_ads, andbusiness_managementpermissions. - Copy the token and paste it into the System User Access Token option when connecting the credential.
Example: daily lead sync
- A Schedule Trigger runs the workflow every day at 8 AM.
- A Meta Lead Forms block with Get Lead Form Leads and
Sinceset to yesterday fetches the new leads. - A Google Sheets block appends each lead's name, email, and campaign to your CRM sheet.
Output
The block returns the leads from the Meta Graph API. Each lead includes its id, created_time, the ad/campaign identifiers, and field_data — an array of { name, values } pairs holding the form answers. Use Response mapping to place the fields you need directly into workflow variables for the next blocks.