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
}

Eventos

Enviar Evento

Envia um evento de rastreamento ao Metrito.

Dois modos de uso

Modo	Como usar	Resolução do container
Autenticado (API key)	`Authorization: Bearer mtk_live_...` ou `x-api-key`	Container resolvido automaticamente pela chave
Público (sem auth)	Sem header de autenticação	Campo `domain` obrigatório no body

O modo público é equivalente ao endpoint legado POST /v2/public/tracking/events — use este endpoint como ponto de entrada único.

Idempotência

Envie Idempotency-Key com um valor único por evento. Dentro de 24h, chamadas repetidas com o mesmo key retornam a resposta original com X-Idempotent-Replayed: true.

POST

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

Campo	Onde é usado	Descrição
`config.name`	Metrito	Nome interno para relatórios e dashboards
`config.facebook.name`	Meta (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

Show child attributes

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

Show child attributes

lead

object

Show child attributes

utm

object

Show child attributes

object

Show child attributes

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

Deletar Gatilho Webhook de Pedido

​Modo Autenticado vs Público

​config.name vs config.facebook.name

Authorizations

Headers

Body

Response

Modo Autenticado vs Público

config.name vs config.facebook.name