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

# LEAD_CREATED

> Disparado quando um novo lead é registrado no checkout, antes de qualquer tentativa de pagamento.

Corresponde ao evento interno `lead.created`. Este evento usa um **envelope diferente** dos eventos de pedido — não contém `purchase` nem `buyer`.

## Quando é disparado

* Comprador acessa o checkout e preenche nome e e-mail
* Lead é registrado mesmo que o pagamento não seja concluído

## Payload

```json theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "lead_id": 456,
  "creation_date": 1736524800000,
  "event": "LEAD_CREATED",
  "version": "2.0.0",
  "data": {
    "lead": {
      "id": 456,
      "code": "uuid-unico-do-lead",
      "name": "Maria Souza",
      "email": "maria@exemplo.com",
      "phone": "+5521988880000",
      "status": "new",
      "ip": "177.0.0.1",
      "user_agent": "Mozilla/5.0 ...",
      "fbp": "fb.1.1700000000000.1234567890",
      "fbc": "fb.1.1700000000000.IwAR...",
      "country": "BR",
      "city": "São Paulo",
      "region": "SP",
      "tracking": {
        "source": "google",
        "utm_source": "google",
        "utm_medium": "cpc",
        "utm_campaign": "black-friday",
        "utm_content": null,
        "utm_term": null,
        "src": null,
        "sck": null
      }
    },
    "product": {
      "id": 1,
      "name": "Curso de Marketing Digital",
      "type": "digital",
      "offer_code": "abc12345",
      "price": 197.00
    }
  }
}
```

## Diferenças em relação aos eventos de pedido

| Propriedade            |      Eventos `order.*`      |    `lead.created`    |
| ---------------------- | :-------------------------: | :------------------: |
| Chave raiz do ID       |          `order_id`         |       `lead_id`      |
| Chave de idempotência  | `data.purchase.transaction` |   `data.lead.code`   |
| Objeto `data.purchase` |              ✓              |           —          |
| Objeto `data.buyer`    |              ✓              |           —          |
| Objeto `data.lead`     |              —              |           ✓          |
| UTM / rastreamento     |   `data.purchase.tracking`  | `data.lead.tracking` |

## Campos-chave

| Campo                             | Descrição                                                                 |
| --------------------------------- | ------------------------------------------------------------------------- |
| `data.lead.code`                  | UUID único do lead — use como chave de idempotência                       |
| `data.lead.status`                | `new` no momento do registro                                              |
| `data.lead.tracking`              | UTMs padronizados + todos os parâmetros de URL capturados no checkout     |
| `data.lead.fbp` / `data.lead.fbc` | Cookies do Meta (`_fbp`/`_fbc`) — úteis para encaminhar à Conversions API |
| `data.product.offer_code`         | Oferta acessada pelo lead                                                 |

<Note>
  Use `data.lead.code` como chave de idempotência. O `id` da **raiz** do payload muda a cada tentativa de entrega — não o use para deduplicar.
</Note>