<!-- BusyBot node reference — https://busybot.net/tools/facebook-lead-ads-trigger/ -->

> Node: Facebook Lead Ads Trigger (`facebook_lead_ads_trigger`) · Webhook trigger · v1
> Category: Marketing · Credentials: Facebook Lead Ads OAuth2 (`facebookLeadAdsOAuth2`)
> Updated: 2026-08-16

# 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](https://busybot.net/credentials/facebook-lead-ads-oauth2/) 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:

```json
{
  "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:

```json
{
  "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:

```json
{
  "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:

```json
{
  "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:

```json
{
  "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.