Ads

Eliminar campañas, conjuntos y anuncios de Meta Ads con la API

Tres rutas DELETE quitan un objeto de la cuenta de anuncios del cliente: campaña, conjunto o anuncio. Usas el id que muestra el Administrador de Anuncios o el uuid de Connect, y la conexión del cliente se encarga del acceso, sin implementar OAuth ni pasar por el app review de Meta.

La llamada

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

Qué puedes hacer

  • Eliminar una campaña con DELETE /ads/campaigns/{id}, que se lleva sus conjuntos y anuncios, en la plataforma y en la base de Connect.
  • Eliminar un conjunto con DELETE /ads/adsets/{id}, que se lleva sus anuncios.
  • Eliminar un anuncio con DELETE /ads/{id}, y la campaña y el conjunto siguen existiendo.
  • Eliminar cualquier objeto de la cuenta, incluso uno creado fuera de Connect, con el id numérico de la plataforma.
  • Listar también los eliminados con include_deleted=true en source=connect, cada uno con deleted_at.

Reglas y límites

  • Eliminar una campaña elimina sus conjuntos y anuncios. Para conservar el historial, pausa en lugar de eliminar.
  • La conexión va siempre en ?customer_integration= y la llamada exige Authorization y x-customer-token.
  • Idempotency-Key es opcional en DELETE. Con él, repetir la llamada devuelve la primera respuesta.
  • El objeto debe ser de la cuenta de la conexión: un id de otra cuenta responde 404 ads_object_not_found, y un uuid que Connect no guarda también.
  • La respuesta 200 trae data con id y deleted. Si la plataforma rechaza, se replica su status e integration_error trae el código.

Campos principales

CampoTipoObligatorioDescripción
idstringSíEn /ads/campaigns/{id}, /ads/adsets/{id} o /ads/{id}: el id numérico del objeto en la plataforma de anuncios (el mismo del Administrador de Anuncios) o el uuid de Connect.
customer_integrationstringSíEl uuid de la conexión del cliente. Define la cuenta de anuncios. Va siempre en la query.
Idempotency-KeystringNoHeader opcional aquí (hasta 255 caracteres). Con él, repetir la llamada devuelve la primera respuesta en lugar de borrar de nuevo.
deletedbooleanNoEn la respuesta, dentro de data: confirma que el objeto fue eliminado, junto con su id.

Para quién

  • Limpiar borradores de campañas

    Una plataforma de gestión de tráfico elimina con un clic las campañas de prueba creadas por error, sin que el cliente abra el Administrador de Anuncios.

  • Agente de IA que ordena cuentas

    Un agente detecta anuncios rechazados y elimina solo esos, manteniendo el conjunto y la campaña para recibir nuevos creativos.

  • Terminar una promoción del cliente

    Una agencia termina una promoción eliminando la campaña, y sus conjuntos y anuncios salen con ella en una sola llamada.

Funciona con

  • Meta Ads

Preguntas frecuentes

¿Eliminar una campaña elimina sus anuncios?

Sí. DELETE /ads/campaigns/{id} se lleva los conjuntos y anuncios, en la plataforma y en la base de Connect. Eliminar un conjunto se lleva sus anuncios, y eliminar un anuncio mantiene el conjunto y la campaña.

¿Puedo ver después lo que se eliminó?

Sí. En las listas con source=connect, include_deleted=true incluye los eliminados, cada uno con deleted_at. Sin ese parámetro no aparecen.

¿Puedo eliminar un objeto creado fuera de Connect?

Sí. El id aceptado es el numérico de la plataforma, que vale para cualquier objeto de la cuenta. Solo se rechaza (404) si el objeto es de otra cuenta.

Relacionadas

Ver todo lo que puedes hacer con Ads

Mira Connect aplicado a tu producto.

Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.