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

CampoTipoObligatorioDescripción
idstringSíEn la ruta: el id del objeto (o el uuid de Connect).
statusstringNoactive o paused.
namestringNoNuevo nombre, si quieres cambiarlo a la vez.
customer_integrationstringSíEn la query: la conexión del cliente con la cuenta de anuncios.
Idempotency-KeystringNoEn 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.

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.