curl --request POST \
--url https://api.metrito.com/v3/tracking/containers/{container_id}/triggers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Compra Aprovada",
"config": {
"trigger": {
"type": "api"
},
"facebook": {
"name": "Purchase",
"track_custom": false
}
}
}
'{
"id": "64a1b2c3d4e5f6a7b8c9d0e2",
"name": "Compra Aprovada",
"domain": "minhaloja.com.br",
"config": {
"trigger": {
"type": "api"
},
"facebook": {
"name": "Purchase",
"track_custom": false
}
},
"created_at": "2026-03-24T14:00:00.000Z"
}{
"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"
}
}Gatilhos
Criar Gatilho
Cria um novo gatilho no container. Via API pública, apenas gatilhos com trigger.type = "api" podem ser criados — o disparo é feito programaticamente via POST /v3/tracking/events.
Suporta header Idempotency-Key para evitar criações duplicadas em caso de retry.
POST
/
v3
/
tracking
/
containers
/
{container_id}
/
triggers
curl --request POST \
--url https://api.metrito.com/v3/tracking/containers/{container_id}/triggers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Compra Aprovada",
"config": {
"trigger": {
"type": "api"
},
"facebook": {
"name": "Purchase",
"track_custom": false
}
}
}
'{
"id": "64a1b2c3d4e5f6a7b8c9d0e2",
"name": "Compra Aprovada",
"domain": "minhaloja.com.br",
"config": {
"trigger": {
"type": "api"
},
"facebook": {
"name": "Purchase",
"track_custom": false
}
},
"created_at": "2026-03-24T14:00:00.000Z"
}{
"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"
}
}Autorizações
bearerAuthapiKeyAuth
JWT da plataforma ou API key mtk_live_...
Cabeçalhos
Chave de idempotência. Dentro de 24h, chamadas repetidas com o mesmo key retornam a resposta original.
Parâmetros de caminho
Identificador do container. Aceita três formatos:
- ObjectId —
64a1b2c3d4e5f6a7b8c9d0e1(encontrado na URL da plataforma após/containers/) - Domínio —
minhaloja.com.br(containers v2, o domínio real) - Metrito Tracking Code —
MTC-AB12(containers v3, visível na sidebar da plataforma)
Exemplos:
"64a1b2c3d4e5f6a7b8c9d0e1"
"minhaloja.com.br"
"MTC-AB12"
Corpo
application/json