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

# Lead

> Contato capturado na vitrine (newsletter, modal, pop-up).

Representa um contato salvo em `store_leads` — **diferente** dos leads de checkout (`leads` / fingerprint).

## Disponível em

* ✅ `storefront.leads.capture()` — POST público na vitrine
* ✅ `useCaptureLead(source)` — hook React
* ✅ `getLeadTrackingContext()` — sessionId + UTMs + pageUrl
* ❌ Listagem no tema — apenas painel seller (`GET /stores/:storeId/leads`)

## CaptureLeadResult

| Campo | Tipo | Descrição |
| - | - | - |
| `success` | `boolean` | Operação ok |
| `lead.id` | `string` | UUID do lead |
| `lead.email` | `string` | E-mail normalizado |
| `lead.isNew` | `boolean` | `true` = primeiro cadastro; `false` = upsert |

## Valores sugeridos para `source`

| Valor | Uso |
| - | - |
| `lead_capture_modal` | Modal de captura |
| `newsletter_footer` | Formulário no rodapé |
| `popup_exit_intent` | Pop-up de saída |
| `landing_page` | Landing dedicada |
| `product_page` | Formulário na PDP |

## Exemplo — hook

```jsx theme={"theme":{"light":"github-light","dark":"github-dark"}}
import { useCaptureLead } from '@corvex/theme-sdk';

export default function NewsletterForm() {
  const { capture, status, error } = useCaptureLead('newsletter_footer');

  async function onSubmit(event) {
    event.preventDefault();
    const email = new FormData(event.currentTarget).get('email');
    await capture({ email, optedIn: true });
  }

  return (
    <form onSubmit={onSubmit}>
      <input name="email" type="email" required />
      <button type="submit" disabled={status === 'loading'}>
        Cadastrar
      </button>
      {status === 'error' ? <p>{error?.message}</p> : null}
    </form>
  );
}
```

Não existe o snippet `@corvex/snippets/lead-capture-form`. Monte o formulário na section e chame o hook.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.