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
}

{
  "error": {
    "type": "validation_error",
    "code": "invalid_parameter",
    "message": "trigger.type must be 'api' for Partner API triggers",
    "request_id": "req_abc123"
  }
}

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "The API key provided is invalid or has been revoked.",
    "request_id": "req_abc123"
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Maximum 120 requests per 60s.",
    "request_id": "req_abc123"
  }
}

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
}

{
  "error": {
    "type": "validation_error",
    "code": "invalid_parameter",
    "message": "trigger.type must be 'api' for Partner API triggers",
    "request_id": "req_abc123"
  }
}

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "The API key provided is invalid or has been revoked.",
    "request_id": "req_abc123"
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Maximum 120 requests per 60s.",
    "request_id": "req_abc123"
  }
}

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.

Autorizações

Authorization

string

header

obrigatório

JWT da plataforma ou API key mtk_live_...

Cabeçalhos

Idempotency-Key

string

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

Corpo

application/json

domain

string

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

Exemplo:

"minhaloja.com.br"

config

object

Show child attributes

version

number

padrão: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

Exemplo:

{
  "_fbp": "fb.1.1234567890.987654321",
  "_ga": "GA1.2.1234567890.1234567890"
}

Resposta

Evento aceito e enfileirado para processamento

success

boolean

event_id

string

lead_id

string | null

timestamp

number

Visão Geral

Plataforma

API de Dados

API de Rastreamento

Enviar Evento

Dois modos de uso

Idempotência

Modo Autenticado vs Público

config.name vs config.facebook.name

Autorizações

Cabeçalhos

Corpo

Resposta

​Modo Autenticado vs Público

​config.name vs config.facebook.name

Autorizações

Cabeçalhos

Corpo

Resposta

Modo Autenticado vs Público

config.name vs config.facebook.name