Skip to main content
PUT
/
v3
/
connections
/
{connection_id}
/
objects
curl --request PUT \
  --url https://api.metrito.com/v3/connections/{connection_id}/objects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "campaign",
  "updates": [
    {
      "id": "120215678901234567",
      "status": "PAUSED"
    }
  ]
}
'
{
  "success": true,
  "summary": {
    "total": 2,
    "successful": 2,
    "failed": 0
  },
  "results": [
    {
      "id": "120215678901234567",
      "success": true,
      "error": null
    },
    {
      "id": "120215678901234568",
      "success": true,
      "error": null
    }
  ]
}

​
Identificando a conexão

O parâmetro connectionId aceita dois formatos:
FormatoExemploQuando usar
ID Metrito64a1b2c3d4e5f6a7b8c9d0e1Padrão — obtido via GET /v3/projects/:id/connections
ID da conta Metaact_123456789 ou 123456789Quando você já tem o ID da conta de anúncios

​
Tipos de objeto suportados

typeO que representa
campaignCampanha
adsetConjunto de anúncios
adAnúncio individual

​
Operações por objeto

OperaçãoCampoValores aceitosSuporta
Pausar / Ativarstatus"ACTIVE", "PAUSED"campaign, adset, ad
Alterar orçamentobudgetInteiro positivo em centavoscampaign, adset
Nota: Anúncios não possuem orçamento próprio. Use campaign ou adset para alterar orçamento.

​
Misturar operações em uma chamada

Você pode misturar operações de status e budget no mesmo array updates. O Metrito agrupa e processa cada tipo separadamente.

​
Exemplos de uso

Pausar uma campanha: 
{
  "type": "campaign",
  "updates": [
    { "id": "120215678901234567", "status": "PAUSED" }
  ]
}
Ativar múltiplos anúncios: 
{
  "type": "ad",
  "updates": [
    { "id": "120215678901234567", "status": "ACTIVE" },
    { "id": "120215678901234568", "status": "ACTIVE" }
  ]
}
Alterar orçamento de múltiplas campanhas: 
{
  "type": "campaign",
  "updates": [
    { "id": "120215678901234567", "budget": 10000 },
    { "id": "120215678901234568", "budget": 5000 }
  ]
}
Pausar e alterar orçamento na mesma chamada: 
{
  "type": "campaign",
  "updates": [
    { "id": "120215678901234567", "status": "PAUSED" },
    { "id": "120215678901234568", "budget": 10000 }
  ]
}

Authorizations

​
Authorization
string
header
required

JWT da plataforma ou API key mtk_live_... enviada no header Authorization

Path Parameters

​
connection_id
string
required

ID da conexão no Metrito (64a1b2c3d4e5f6a7b8c9d0e1) ou ID da conta de anúncios na plataforma (act_123456789 para Meta Ads).

Example:

"64a1b2c3d4e5f6a7b8c9d0e1"

Body

application/json
​
type
enum<string>
required

Tipo do objeto a ser atualizado.

Available options:
campaign,
adset,
ad
Example:

"campaign"

​
updates
(Alterar status · object | Alterar orçamento · object)[]
required

Lista de objetos a atualizar. Cada item deve conter id e exatamente um de status ou budget.

Minimum array length: 1

Response

Todas as atualizações foram aplicadas com sucesso.

​
success
boolean

True only if every update in the batch succeeded.

​
summary
object
​
results
object[]