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

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.