Skip to main content
POST
Registra uma venda

Authorizations

Authorization
string
header
required

Authorization: Bearer mcp_… — gere em Configurações → Tokens de API.

O token tem modo read ou write. Um token read responde 403 a qualquer verbo que não seja GET. As capacidades do token são a interseção com as da pessoa que o emitiu: se ela perder acesso na grade de Equipe, o token perde junto, sem ninguém revogar nada.

Body

application/json
lead_id
string<uuid>
required
value
number
required
Example:

67

sold_at
string
required

Quando o cliente comprou, não quando você está lançando.

O offset é obrigatório. O Metricaas grava em UTC; se você mandar 2026-08-07T00:52:14 sem fuso, a compra da madrugada vira o dia anterior em todo relatório. Sem offset a API responde 422 em vez de adivinhar.

Example:

"2026-08-07T11:49:12-03:00"

currency
string
default:BRL
product_id
string<uuid> | null
external_source
string
Example:

"hotmart"

external_id
string
Example:

"HP2346486658"

Response

Já existia (mesmo external_source + external_id)

id
string<uuid>
lead_id
string<uuid>
value
number
sold_at
string<date-time>
stage
string
duplicate
boolean

true quando o par external_source+external_id já existia.