Lead created (lead.created)

Description

Triggered when a lead event is recorded (for example a signup), including attribution derived from links and UTM parameters where available.

Payload structure

{
  "eventId": "string (uuid)",
  "eventType": "lead.created",
  "timestamp": "string (ISO-8601)",
  "schemaVersion": 1,
  "payload": {}
}

Fields

Root (envelope)

Field	Type	Description
eventId	string	Unique identifier for this webhook delivery.
eventType	string	Always lead.created for this event.
timestamp	string	Time the event was emitted.
schemaVersion	number	Version of schema.
payload	object	Lead and attribution details.

Payload object (payload)

Field	Type	Description
eventId	string	Identifier for the lead event itself (distinct from root envelope eventId).
timestamp	string	Time the lead event occurred (distinct from root envelope timestamp).
customerId	string	Customer identifier associated with the lead.
eventName	string	Lead event name (for example signup).
transactionId	string | null	Related transaction id when present; otherwise null.
attribution	object	Attribution snapshot (see below).
country	string	Country associated with the lead when known.
city	string	City associated with the lead when known.
platform	string	Platform classification (for example mobile).
adIds	object	Attribution click IDs captured from the link or session (see below).

payload.attribution

Field	Type	Description
shortUrl	string	Short URL associated with attribution.
utmSource	string	UTM source when captured.
utmMedium	string	UTM medium when captured.
utmCampaign	string	UTM campaign when captured.
firstTouchLink	string	First-touch link reference.
lastTouchLink	string	Last-touch link reference.

payload.adIds

Field	Type	Description
fbclid	string | null	Meta — Facebook Click Identifier. Used by Meta Pixel / Conversions API (CAPI) to attribute conversions to Facebook/Instagram ads.
gclid	string | null	Google Ads — Google Click Identifier. Used for offline conversions and campaign performance tracking.
gbraid	string | null	Google Ads — App iOS Click ID. For iOS 14.5+ traffic directed to an app; supports privacy-compliant modeled attribution.
wbraid	string | null	Google Ads — Web iOS Click ID. For iOS 14.5+ traffic directed to a website; supports privacy-compliant modeled attribution.
ttclid	string | null	TikTok — TikTok Click ID. Used by TikTok Pixel and Events API to link actions back to TikTok campaigns.

Working with Ad Click IDs

payload.adIds carries click identifiers from ad platforms (Meta, Google, TikTok) when they were present on the attributed link. In production, expect at most one non-null value — the platform that actually drove the click.

Rules for consumers

• One active ID per event — adIds is mutually exclusive in production. Only one key holds a non-null string; the rest are null. That value identifies which ad network drove the session.
• Google uses exactly one ID type — gclid, gbraid, and wbraid are never set together. Google assigns one based on traffic type:
  • Desktop or Android web/app → gclid
  • iOS web (Safari) → wbraid
  • iOS in-app deep link → gbraid
• Route by non-null key — Send the populated ID to the matching downstream system (Meta CAPI, Google Ads offline conversions, TikTok Events API, CRM, data warehouse, etc.). Ignore keys that are null.

Typical production shapes

Scenario A — Meta ad (Instagram / Facebook)

{
  "adIds": {
    "fbclid": "IwAR2xK9aBc123xyz456_ExampleString_789",
    "gclid": null,
    "gbraid": null,
    "wbraid": null,
    "ttclid": null
  }
}

Scenario B — Google Search ad on iPhone (web)

{
  "adIds": {
    "fbclid": null,
    "gclid": null,
    "gbraid": null,
    "wbraid": "ClgKCQjwhO3DBhDaARJHAPBAqMmEZWE7Gt_zJEt",
    "ttclid": null
  }
}

note

The full example payload below shows every adIds key populated for complete schema reference. In live traffic, only one key will be non-null at a time.

Example payload

{
  "eventId": "4cc50071-d8e8-4089-9dd2-2894e29e3a88",
  "eventType": "lead.created",
  "schemaVersion": 1,
  "timestamp": "2026-04-29T13:05:15.368009",
  "payload": {
    "eventId": "56bd5fb3-8418-4813-8559-d37fd3e65f04",
    "timestamp": "2026-04-29T13:05:15.368009",
    "customerId": "CUST1017",
    "eventName": "signup",
    "transactionId": null,
    "attribution": {
      "shortUrl": "zeustechnology.trycleansify.com/profileManager",
      "utmSource": "pmgatishakti",
      "utmMedium": "official-website",
      "utmCampaign": "national-master-plan-gati-shakti",
      "firstTouchLink": "zeustechnology.trycleansify.com/profileManager",
      "lastTouchLink": "zeustechnology.trycleansify.com/profileManager"
    },
    "country": "India",
    "city": "Bhilai",
    "platform": "mobile",
    "adIds": {
      "fbclid": "IwY2xjawR9OhlleHRuA2FlbQIxMQBzcnRjBmFwcF9pZAwzNTA2ODU1MzE3MjgAAR7PIdCfTw5a8i37AfDaVlZLvWaMdJwQEr75JEPtbfWcTrnPaUu7Tpj_3OvS-A_aem_0FItaF20o94lSQX6izgv5g",
      "gclid": "EAIaIQobChMIu_v0r_f9_wIVh7LICh0wQQT_EAAYASAAEgK_v_D_BwE",
      "gbraid": "0AAAAACZGY6vERiXMMTJYoB2VG86-qHLmR",
      "wbraid": "ClgKCQjwhO3DBhDaARJHAPBAqMmEZWE7Gt_zJEt",
      "ttclid": "1766471830193154_1_726359051_1"
    }
  }
}

Notes

• Root eventId / timestamp identify the webhook delivery; inner payload.eventId / payload.timestamp identify the business lead event.