Skip to main content
POST
/
v3
/
tracking
/
events
curl --request POST \
  --url https://api.metrito.com/v3/tracking/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "config": {
    "name": "PageView"
  }
}
'
{
  "success": true,
  "event_id": "1758388123_kk78h7u5sf",
  "lead_id": "lead_20260324_xyz789",
  "timestamp": 1758388123
}

​
Modo Autenticado vs Público

Com API key — o container é resolvido automaticamente pela chave. O campo domain no body é ignorado (mas pode ser enviado). Público (sem auth) — o campo domain é obrigatório e identifica o container de destino.

​
config.name vs config.facebook.name

CampoOnde é usadoDescrição
config.nameMetritoNome interno para relatórios e dashboards
config.facebook.nameMeta (Facebook/Instagram)Nome enviado à Meta Conversion API (PageView, Purchase, Lead, etc.)
Se config.facebook for omitido, o evento é registrado no Metrito mas não é enviado para a Meta.

Authorizations

​
Authorization
string
header
required

JWT da plataforma ou API key mtk_live_...

Headers

​
Idempotency-Key
string

Chave de idempotência. Dentro de 24h, chamadas repetidas com o mesmo key retornam a resposta original.

Body

application/json
​
domain
string

Domínio do container. Obrigatório no modo público (sem API key). Ignorado no modo autenticado.

Example:

"minhaloja.com.br"

​
config
object
​
version
number
default:2
​
event_id
string

ID único do evento. Gerado automaticamente se omitido.

​
event_time
number

Timestamp Unix em segundos. Usa horário atual se omitido.

​
data
object
​
lead
object
​
utm
object
​
cookies
object
Example:
{
  "_fbp": "fb.1.1234567890.987654321",
  "_ga": "GA1.2.1234567890.1234567890"
}

Response

Evento aceito e enfileirado para processamento

​
success
boolean
​
event_id
string
​
lead_id
string | null
​
timestamp
number