Skip to main content
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"
}

​
Tipo de Disparo

Via API pública, apenas trigger.type = "api" é suportado. Gatilhos de outros tipos (pageview, click, scroll) são criados via interface da plataforma Metrito.

​
Mapeamento Meta

O campo config.facebook.name define qual evento padrão da Meta será disparado quando este gatilho for ativado. Valores suportados: Purchase, Lead, PageView, AddToCart, InitiateCheckout, etc.

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.

Path Parameters

​
container_id
string
required

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)
Examples:

"64a1b2c3d4e5f6a7b8c9d0e1"

"minhaloja.com.br"

"MTC-AB12"

Body

application/json
​
name
string
required

Nome descritivo do gatilho

Example:

"Compra Aprovada"

​
config
object
required

Response

Gatilho criado com sucesso

​
id
string

ID único do gatilho

​
name
string

Nome do gatilho

​
description
string | null
​
domain
string

Domínio do container

​
is_automatic
boolean | null
​
config
object
​
created_at
string<date-time>