Ads
Pausar y activar campañas, conjuntos y anuncios con la API
Encender y apagar anuncios es un PATCH con status active o paused, en el nivel que quieras controlar: campaña, conjunto o anuncio. Funciona con cualquier objeto de la cuenta conectada, incluidos los creados directamente en el Administrador de Anuncios. Sin implementar la API de Meta.
La llamada
PATCH /api/ads/campaigns/{id}?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>
{
"status": "active"
}Qué puedes hacer
- Pausar o activar una campaña con PATCH /ads/campaigns/{id}.
- Pausar o activar un conjunto con PATCH /ads/adsets/{id}.
- Pausar o activar un anuncio con PATCH /ads/{id}.
- Cambiar el nombre en el mismo PATCH.
- Identificar el objeto por el id de la plataforma o por el uuid de Connect.
Reglas y límites
- Valores aceptados en status: active y paused.
- Funciona con cualquier objeto de la cuenta, incluidos los creados fuera de Connect: se guarda en la primera escritura.
- Idempotency-Key es opcional en PATCH.
- El id se comprueba contra la cuenta de la conexión; de otra cuenta, la respuesta es 404 ads_object_not_found.
- La conexión de customer_integration debe pertenecer al cliente (403 si no) y estar vigente (422 ads_connection_expired si el token expiró).
- La respuesta es síncrona (200).
Campos principales
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | string | Sí | En la ruta: el id del objeto (o el uuid de Connect). |
| status | string | No | active o paused. |
| name | string | No | Nuevo nombre, si quieres cambiarlo a la vez. |
| customer_integration | string | Sí | En la query: la conexión del cliente con la cuenta de anuncios. |
| Idempotency-Key | string | No | En el header. Opcional en PATCH, recomendado para poder repetir con seguridad. |
Para quién
Interruptor en el panel
Tu cliente pausa una campaña desde tu producto, sin abrir el Administrador de Anuncios.
Regla automática de seguridad
Pausa anuncios cuando una métrica pase un límite que defines, como un costo por resultado alto.
Agente de IA que gestiona presupuesto
El agente pausa lo que rinde mal y activa lo aprobado, todo con llamadas simples.
Funciona con
Meta Ads
Preguntas frecuentes
¿Debo haber creado el anuncio con Connect para pausarlo?
No. Cualquier objeto de la cuenta conectada se puede pausar o activar; entra en los registros de Connect en la primera escritura.
¿Qué valores de status se aceptan?
active y paused.
¿Puedo repetir la llamada con seguridad?
Sí. Envía un Idempotency-Key (opcional en PATCH) y una repetición con la misma clave devuelve la respuesta de la primera.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
