Facebook Lead Ads Trigger

Start workflow from Facebook Lead Ad submissions

Overview

Receives real-time webhook events from Facebook when new leads are submitted through Lead Ad forms. Validates incoming payloads using HMAC-SHA256 signature verification with the Facebook App Secret. Handles Facebook URL verification challenges (GET requests with hub.challenge). Filters events by configured Page ID and Form ID, then outputs structured lead data including form field values, ad details, adset details, and page information. Supports simplified output (flattened key-value fields) or full raw output with nested field_data arrays and form questions.

Category: Marketing
Tool Name: facebook_lead_ads_trigger
Version: 1

Appearance: Icon: si-facebook | Color: #1877f2

Node Type

Trigger — webhook (receives incoming HTTP callbacks)

This node is not listed in the node panel — it is placed as part of another node’s pattern.

Input / Output

Direction	Port(s)
Input	None (trigger node)
Output	Output

Credentials

This tool requires Facebook Lead Ads OAuth2 credentials. See the Credentials Guide for setup instructions.

Parameters

Parameter	Type	Required	Default	Description
Facebook Account	credential	No	—	Connect your Facebook account via OAuth2.
Event	options	Yes	newLead	The event to listen for.
				Options: newLead (New Lead)
Page ID	string	Yes	—	The ID of the Facebook Page linked to the lead form. You can find this in your Facebook Page settings.
Form ID	string	Yes	—	The ID of the specific Lead Ad form to monitor. You can find this in Facebook Ads Manager under Lead Forms.
Options	collection	No	{}	Additional output settings.
— Simplify Output	boolean	No	true	Whether to return a simplified version of the lead data (flattened field key-value pairs) instead of the raw nested structure.

Output Data

One output item is produced per lead submission that matches the configured Page ID and Form ID. Deliveries for other pages or forms are acknowledged without starting the workflow.

Each item carries:

• _trigger — always facebook_lead_ads_webhook
• _timestamp — ISO 8601 timestamp of when the request arrived
• _webhookEvent — always leadgen
• leadgen_id — the ID of the submitted lead
• form_id — the Lead Ad form the lead came from
• page_id — the Facebook Page the form is attached to
• ad_id, adgroup_id — the ad and adset that produced the lead
• created_time — when Facebook recorded the submission

The event carries lead identifiers rather than the answers the person typed. To read the submitted field values, pass leadgen_id to a downstream node that calls the Facebook Graph API.

Reference the payload downstream by expression, e.g. {{ $json.leadgen_id }}.

Usage Examples

• capture new leads from Facebook ad campaigns
• trigger workflow when someone fills out a Facebook Lead Ad form
• receive Facebook lead ad submissions in real time
• collect leads from Facebook advertising forms

Example Configuration

Watch one Lead Ad form on one page:

{
  "name": "Facebook Lead Ads Trigger",
  "type": "facebook_lead_ads_trigger",
  "position": [250, 300],
  "parameters": {
    "event": "newLead",
    "pageId": "123456789012345",
    "formId": "987654321098765"
  }
}

The same, with output settings spelled out:

{
  "name": "Facebook Lead Ads Trigger",
  "type": "facebook_lead_ads_trigger",
  "position": [250, 300],
  "parameters": {
    "event": "newLead",
    "pageId": "123456789012345",
    "formId": "987654321098765",
    "options": {
      "simplifyOutput": true
    }
  }
}

Return the raw nested structure instead:

{
  "name": "Facebook Lead Ads Trigger",
  "type": "facebook_lead_ads_trigger",
  "position": [250, 300],
  "parameters": {
    "event": "newLead",
    "pageId": "555666777888999",
    "formId": "111222333444555",
    "options": {
      "simplifyOutput": false
    }
  }
}

Monitor leads from a real estate page and lead form:

{
  "name": "Real Estate Leads",
  "type": "facebook_lead_ads_trigger",
  "position": [250, 300],
  "parameters": {
    "event": "newLead",
    "pageId": "123456789012345",
    "formId": "456789012345678",
    "options": {
      "simplifyOutput": true
    }
  }
}

Capture newsletter signups:

{
  "name": "Newsletter Signups",
  "type": "facebook_lead_ads_trigger",
  "position": [250, 300],
  "parameters": {
    "event": "newLead",
    "pageId": "987654321098765",
    "formId": "789012345678901",
    "options": {
      "simplifyOutput": true
    }
  }
}

Trigger Behavior

• Activation: When the workflow is activated, a webhook endpoint is registered with the service.
• Deactivation: The webhook is automatically unregistered when the workflow is deactivated.
• Payload: The incoming webhook payload is parsed and output as workflow items.
• Verification: Supports signature verification where applicable.

Tips

Entry point that fires when a new lead is submitted through a Facebook Lead Ad form. Validates the webhook signature, filters by page and form, and outputs the lead data including form field values, ad info, and page details.

• Due to Facebook API limitations, you can use just one Facebook Lead Ads trigger for each Facebook App.