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
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| id | string | Sim | Em /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_integration | string | Sim | uuid da conexão do cliente. Define a conta de anúncios. Vai sempre na query. |
| Idempotency-Key | string | Não | Header opcional aqui (até 255 caracteres). Com ele, repetir a chamada devolve a primeira resposta em vez de apagar de novo. |
| deleted | boolean | Não | Na 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.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
