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
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | string | Sí | 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_integration | string | Sí | El uuid de la conexión del cliente. Define la cuenta de anuncios. Va siempre en la query. |
| Idempotency-Key | string | No | Header opcional aquí (hasta 255 caracteres). Con él, repetir la llamada devuelve la primera respuesta en lugar de borrar de nuevo. |
| deleted | boolean | No | En 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.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
