> ## Documentation Index
> Fetch the complete documentation index at: https://learn.biq.li/llms.txt
> Use this file to discover all available pages before exploring further.

# lead.created

> Receive an attributed lead with customer, click, link, and metadata context.

Biqli sends `lead.created` when conversion tracking records a new lead. A retried tracking request that replays an existing idempotent result does not create a second lead event.

## Example payload

```json theme={null}
{
  "id": "evt_01m2examplelead000000000000",
  "event": "lead.created",
  "createdAt": "2026-09-14T15:10:00+00:00",
  "data": {
    "eventName": "Signed up",
    "externalId": "signup_1842",
    "customer": {
      "id": "biq_cus_01M2EXAMPLE00000000000000",
      "externalId": "customer_1842",
      "email": "ada@example.com",
      "name": "Ada Lovelace",
      "avatar": null
    },
    "click": {
      "id": "click_example_1842",
      "timestamp": "2026-09-14T15:04:59+00:00",
      "country": "US",
      "city": "San Francisco",
      "region": "California",
      "browser": "Chrome",
      "browserVersion": "128",
      "platform": "Mac OS",
      "platformVersion": "14",
      "device": "desktop",
      "referrer": "https://example.com",
      "source": null
    },
    "link": {
      "id": "biq_lnk_01M2EXAMPLE00000000000000",
      "externalId": "campaign_1842",
      "name": "Autumn campaign",
      "url": "https://example.com/autumn",
      "shortUrl": "https://biq.li/autumn",
      "key": "autumn",
      "description": null,
      "active": true,
      "expiresAt": null,
      "workspaceId": "biq_ws_01M2EXAMPLE000000000000000",
      "createdAt": "2026-09-14T13:40:23+00:00",
      "updatedAt": "2026-09-14T13:40:23+00:00"
    },
    "metadata": {
      "plan": "pro"
    }
  }
}
```

## Field notes

* `externalId` identifies the lead event in the source system and can be `null`.
* `customer.externalId` identifies the customer in the source system.
* Customer profile fields and click enrichment can be `null`.
* Conversion click context intentionally omits the IP address.
* `metadata` is integration-defined JSON and can be `null`.

If the attributed link was later deleted, `data.link` contains its preserved historical values and `deleted: true`.