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
/
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
}{
"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 campodomain 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..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.) |
config.google.name | Google Ads | Nome da ação de conversão na conta. Criada automaticamente se não existir |
config.tiktok.name | TikTok Ads | Evento padrão (CompletePayment, SubmitForm, etc.) ou nome personalizado |
config.facebook, o evento é registrado no Metrito mas não vai para a Meta; o mesmo vale para config.google e config.tiktok. O envio também exige um destino ativo daquela fonte no container.Autorizações
bearerAuthapiKeyAuth
Cabeçalhos
Corpo
application/json
Fonte do evento, exibida na coluna "Fonte" do histórico do lead. Eventos desta API são rotulados como api por padrão. Valores fora da lista voltam para api. Diferente de config.facebook.sourceKey, que governa o action_source da Meta.
Opções disponíveis:
api, whatsapp, website Exemplo:
"whatsapp"