Ads

Apagar campanhas, conjuntos e anúncios do Meta Ads pela API

Três rotas DELETE apagam um objeto da conta de anúncios do cliente: campanha, conjunto ou anúncio. Você usa o id que o Gerenciador de Anúncios mostra ou o uuid do Connect, e a conexão do cliente cuida do acesso, sem implementar OAuth nem passar pelo app review da Meta.

A chamada

DELETE /api/ads/campaigns/120250000000000001?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

O que dá para fazer

  • Apagar uma campanha com DELETE /ads/campaigns/{id}, que leva os conjuntos e anúncios dela junto, na plataforma e no banco do Connect.
  • Apagar um conjunto com DELETE /ads/adsets/{id}, que leva os anúncios dele junto.
  • Apagar um anúncio com DELETE /ads/{id}, e a campanha e o conjunto continuam existindo.
  • Apagar qualquer objeto da conta, inclusive o criado fora do Connect, usando o id numérico da plataforma.
  • Listar também os apagados com include_deleted=true em source=connect, onde cada um traz deleted_at.

Regras e limites

  • Apagar uma campanha apaga os conjuntos e anúncios dela. Para preservar o histórico, pause em vez de apagar.
  • A conexão vai sempre em ?customer_integration= e a chamada exige Authorization e x-customer-token.
  • O Idempotency-Key é opcional no DELETE. Com ele, repetir a chamada devolve a primeira resposta.
  • O objeto precisa ser da conta da conexão: um id de outra conta responde 404 ads_object_not_found, e um uuid que o Connect não guarda também.
  • A resposta 200 traz data com id e deleted. Se a plataforma recusar, o status dela é espelhado e integration_error traz o código.

Campos principais

CampoTipoObrigatórioDescrição
idstringSimEm /ads/campaigns/{id}, /ads/adsets/{id} ou /ads/{id}: o id numérico do objeto na plataforma de anúncios (o mesmo do Gerenciador de Anúncios) ou o uuid do Connect.
customer_integrationstringSimuuid da conexão do cliente. Define a conta de anúncios. Vai sempre na query.
Idempotency-KeystringNãoHeader opcional aqui (até 255 caracteres). Com ele, repetir a chamada devolve a primeira resposta em vez de apagar de novo.
deletedbooleanNãoNa resposta, em data: confirma que o objeto foi apagado, junto com o id.

Para quem

  • Limpar rascunhos de campanhas

    Uma plataforma de gestão de tráfego apaga campanhas de teste criadas por engano com um clique, sem o cliente abrir o Gerenciador de Anúncios.

  • Agente de IA que arruma contas

    Um agente identifica anúncios reprovados e apaga só eles, mantendo o conjunto e a campanha para receber novos criativos.

  • Encerrar uma ação do cliente

    Uma agência encerra uma promoção apagando a campanha, e os conjuntos e anúncios saem junto numa única chamada.

Funciona com

  • Meta Ads

Perguntas frequentes

Apagar uma campanha apaga os anúncios dela?

Sim. DELETE /ads/campaigns/{id} leva os conjuntos e anúncios junto, na plataforma e no banco do Connect. Apagar um conjunto leva os anúncios dele, e apagar um anúncio mantém o conjunto e a campanha.

Dá para ver o que foi apagado depois?

Dá. Nas listagens com source=connect, include_deleted=true inclui os apagados, cada um com deleted_at. Sem esse parâmetro eles não aparecem.

Posso apagar um objeto criado fora do Connect?

Pode. O id aceito é o numérico da plataforma, que vale para qualquer objeto da conta. Só é recusado (404) se o objeto for de outra conta.

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.