---
title: "Lead received event"
method: POST
path: "lead.received"
tags: ["Webhook Events"]
---

# Lead received event

`POST lead.received` (webhook)

Fired when a new lead is submitted against a Meta Lead Gen (Instant) Form
and ingested via the Page `leadgen` webhook. `lead.fields` is the
question-key to answer map; `lead.formId` / `lead.adId` give provenance.
Requires the Ads add-on.

## Payload

- WebhookPayloadLead — Webhook payload for lead.received events (Meta Lead Gen / Instant Forms).
  - `id` string, required — Stable webhook event ID
  - `event` 'lead.received', required
  - `lead` object, required
    - `id` string, required — Zernio lead ID (AdLead document ID)
    - `leadgenId` string, required — Meta lead ID (the platform's leadgen_id)
    - `formId` string, required — Lead Gen form ID the lead was submitted against
    - `formName` string, nullable — Human-readable form name (best-effort; may be null)
    - `adId` string, nullable — Meta ad ID that drove the lead (null for organic/test leads)
    - `adsetId` string, nullable
    - `campaignId` string, nullable
    - `fields` object, required — Flattened question key -> answer map. For multiple-choice questions the value is the option key (e.g. "k1"), not the display label.
    - `isOrganic` boolean, required — True when the lead came from an organic post rather than a paid ad
    - `createdAt` string, date-time, required — Meta's lead creation time (ISO 8601)
  - `account` object, required
    - `id` string, required — Social account ID (the facebook account owning the Page)
    - `accountId` string — Social account ID (same as id); canonical field for account filtering.
    - `platform` 'facebook', required
  - `timestamp` string, date-time, required

## Acknowledgement `200`

Webhook received successfully

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/51932b099b2f/schema)