> ## 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.

# Newsletter Capture

> Cookbook — captura de leads com useCaptureLead e storefront.leads.capture.

> Quero um formulário de newsletter / lead capture na vitrine. Como implementar?

Referência: `seu tema (adaptado do cookbook)`

Índice: [Cookbooks](https://docs-loja.usecorvex.com.br/cookbook/overview.md)

***

## Contratos utilizados

* [leads.capture](https://docs-loja.usecorvex.com.br/data/actions/leads-capture.md)
* `@corvex/theme-sdk` — `useCaptureLead`

***

## API pública

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

const { capture, status, error, isNew, reset } = useCaptureLead('newsletter_footer');

await capture({
  email: 'maria@example.com',
  optedIn: true,
});
```

O hook injeta automaticamente `pageUrl`, `referrer` e UTMs via `getLeadTrackingContext()`.

| Campo | Obrigatório |
| - | - |
| `email` | ✅ |
| `optedIn` | Recomendado para marketing |
| `fields` | Opcional (`name`, `phone`, …) |
| `source` | Default do hook. O exemplo usa `newsletter_footer` |

***

## UX recomendada

1. Campo e-mail + checkbox de consentimento (`optedIn`)
2. Estados: `idle` → `loading` → `success` / `error`
3. Mensagem de sucesso após `status === 'success'`
4. Desabilitar submit durante `loading`

***

## Escopo

* Section na vitrine (rodapé, home, landing)
* O cliente não impõe cota por minuto. Se a API responde 429, o erro tem `code: 'RATE_LIMIT_EXCEEDED'`

***

## Settings do cookbook

| Setting | Uso |
| - | - |
| `title`, `description` | Cabeçalho |
| `emailPlaceholder`, `buttonLabel` | Formulário |
| `successText` | Após cadastro |
| `optInLabel` | Texto do consentimento |

`enabledOn: ['index', 'page', 'collection']`

***

## Checklist

* [ ] `useCaptureLead(source)` com source estável
* [ ] `optedIn: true` quando usuário consente
* [ ] Tratar `error` e `status`
* [ ] `corvex validate .`

***

## Veja também

* [Header](https://docs-loja.usecorvex.com.br/cookbook/header.md) — outro ponto de captura no layout
* [Lead resource](https://docs-loja.usecorvex.com.br/data/resources/lead.md) (se documentado)


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