---
title: "Encaminhar um caso comercial ou técnico para uma pessoa"
method: POST
path: "/leads"
tags: ["Contato"]
---

# Encaminhar um caso comercial ou técnico para uma pessoa

`POST /leads`

## Request

- Base URL: `https://api.luniumpay.com`
- URL: `https://api.luniumpay.com/leads`
- Auth: none required

Rota pública, sem chave. Use somente para preço por volume, contrato, parceria ou um caso que a documentação não resolve. O endereço precisa ter sido fornecido pela própria pessoa para este contato; não descubra, não raspe e não reutilize e-mail de outra finalidade. Para começar sem falar com ninguém, use `POST /keys/sandbox`.

## Request body

- object
  - `email` string, email, required
  - `nome` string
  - `empresa` string
  - `whatsapp` string
  - `mensagem` string
  - `fluxo` 'cashin' | 'cashout' | 'cashin_cashout' | 'payout' | 'outro' | 'custody'
  - `volume_mensal` string
  - `prazo` string
  - `estagio_produto` string
  - `como_encontrou` string: Fonte declarada pela pessoa, separada do UTM. Ex.: chatgpt, google, indicacao.
  - `consentimento` true, required: Confirma que a pessoa forneceu o contato para receber resposta sobre esta solicitação.
  - `origem` string: Página ou contexto onde a solicitação começou.
  - `utm_source` string
  - `utm_medium` string
  - `utm_campaign` string
  - `utm_content` string
  - `utm_term` string
  - `ref_agent` string
  - `website` string: Honeypot: clientes legítimos devem omitir ou enviar vazio.

## Response `200`

Contato existente atualizado dentro da janela de deduplicação. Com consentimento explícito, devolve um novo lead_token e invalida o anterior.

- object
  - `ok` true, required
  - `lead_id` integer
  - `lead_token` string: Opaque attribution token returned with explicit consent. Send only in POST /keys, POST /keys/sandbox or lunium_start_sandbox_demo. Never place it in URLs or logs.
  - `detail` string
  - `integration_url` string, uri: Start the self-service integration immediately; human contact is optional.

## Other responses

- `201`: Contato recebido. Com consentimento explícito, lead_token liga este contato à chave criada em seguida.
- `400`: E-mail ou corpo inválido.
- `429`: Muitas tentativas pelo mesmo endereço.
- `503`: Contato não pôde ser persistido; tente novamente ou use o e-mail publicado.

---

[API](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil.md) · [All operations](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/llms.txt) · [OpenAPI document](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/revisions/0b5a340fa9dd?raw)