Ads

Pausar e ativar campanhas, conjuntos e anúncios pela API

Ligar e desligar anúncios é um PATCH com status active ou paused, no nível que você quer controlar: campanha, conjunto ou anúncio. Funciona para qualquer objeto da conta conectada, inclusive os criados direto no Gerenciador de Anúncios. Sem implementar a API do Meta.

A chamada

PATCH /api/ads/campaigns/{id}?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

{
  "status": "active"
}

O que dá para fazer

  • Pausar ou ativar uma campanha com PATCH /ads/campaigns/{id}.
  • Pausar ou ativar um conjunto com PATCH /ads/adsets/{id}.
  • Pausar ou ativar um anúncio com PATCH /ads/{id}.
  • Trocar o nome no mesmo PATCH.
  • Identificar o objeto pelo id da plataforma ou pelo uuid do Connect.

Regras e limites

  • Valores aceitos em status: active e paused.
  • Funciona para qualquer objeto da conta, inclusive criados fora do Connect: ele passa a ser guardado na primeira escrita.
  • Idempotency-Key é opcional em PATCH.
  • O id é conferido contra a conta da conexão; de outra conta, a resposta é 404 ads_object_not_found.
  • A conexão em customer_integration precisa pertencer ao cliente (403 se não pertencer) e estar válida (422 ads_connection_expired se o token expirou).
  • A resposta é síncrona (200).

Campos principais

CampoTipoObrigatórioDescrição
idstringSimNo caminho: o id do objeto (ou o uuid do Connect).
statusstringNãoactive ou paused.
namestringNãoNovo nome, se quiser mudar junto.
customer_integrationstringSimNa query: a conexão do cliente com a conta de anúncios.
Idempotency-KeystringNãoNo header. Opcional em PATCH, recomendado para poder repetir com segurança.

Para quem

  • Botão liga/desliga no painel

    Seu cliente pausa uma campanha direto no seu produto, sem abrir o Gerenciador de Anúncios.

  • Regra automática de segurança

    Pause anúncios quando uma métrica passar de um limite que você define, como custo por resultado alto.

  • Agente de IA que gerencia verba

    O agente pausa o que performa mal e ativa o que foi aprovado, tudo por chamadas simples.

Funciona com

  • Meta Ads

Perguntas frequentes

Preciso ter criado o anúncio pelo Connect para pausá-lo?

Não. Qualquer objeto da conta conectada pode ser pausado ou ativado; ele entra na base do Connect na primeira escrita.

Quais valores de status são aceitos?

active e paused.

Posso repetir a chamada com segurança?

Sim. Envie um Idempotency-Key (opcional em PATCH) e a repetição com a mesma chave devolve a resposta da primeira.

Relacionadas

Ver tudo que dá para fazer em Ads

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.