Ads

Duplicar un anuncio, conjunto o campaña de Meta Ads con la API

Clona un anuncio, un conjunto o una campaña de la cuenta del cliente sin rehacer todo. Puedes ajustar nombre, presupuesto, agenda o la campaña de destino en la misma llamada. La copia nace pausada, así que nada gasta hasta que la actives.

La llamada

POST /api/ads/{id}/duplicate?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

{
  "name": "Black Friday, copy"
}

Qué puedes hacer

  • Duplicar un anuncio con POST /ads/{id}/duplicate.
  • Duplicar un conjunto con POST /ads/adsets/{id}/duplicate, eligiendo otra campaña de destino con campaign_id.
  • Duplicar una campaña con POST /ads/campaigns/{id}/duplicate.
  • Cambiar el nombre de la copia y, en conjunto y campaña, el presupuesto.
  • Cambiar la fecha de inicio de un conjunto copiado.
  • Usar el id numérico de la plataforma o el uuid de Connect.

Reglas y límites

  • Idempotency-Key es obligatorio en el header; repetir con la misma clave devuelve 200 con Idempotent-Replay: true, sin crear otra copia.
  • La copia de un anuncio siempre se crea pausada, en el mismo conjunto. En conjunto y campaña, status es paused por defecto.
  • name es obligatorio al duplicar conjunto y campaña, y opcional al duplicar un anuncio.
  • El presupuesto sigue la regla CBO/ABO: enviarlo al nivel equivocado responde 409 budget_level_mismatch.
  • El objeto debe existir en la cuenta de la conexión; un id de otra cuenta responde 404 ads_object_not_found.
  • La respuesta es síncrona (201).

Campos principales

CampoTipoObligatorioDescripción
idstringSíEn la ruta: el id del anuncio, conjunto o campaña a copiar (o el uuid de Connect).
namestringSíNombre de la copia. Opcional al duplicar un anuncio (sin nombre, la plataforma asigna uno); obligatorio para conjunto y campaña.
statusstringNoSolo en conjunto y campaña: paused (por defecto) o active.
campaign_idstringNoSolo en conjunto: la campaña de destino. Sin él, la copia queda en la campaña de origen.
budget.amountnumberNoSolo en conjunto y campaña: nuevo presupuesto, en la moneda de la cuenta.
schedule.startstringNoSolo en conjunto: nueva fecha de inicio.

Para quién

  • Escalar lo que funciona

    Duplica un conjunto ganador con más presupuesto u otra campaña de destino, y actívalo cuando esté listo.

  • Pruebas de creativos

    Copia un anuncio y luego cambia el texto o el título de la copia para comparar variaciones.

  • Plantillas por cliente

    Mantén una campaña modelo y duplícala para cada cliente nuevo, cambiando solo el nombre y el presupuesto.

Funciona con

  • Meta Ads

Preguntas frecuentes

¿La copia empieza a gastar?

La copia de un anuncio siempre nace pausada. Para conjunto y campaña el valor por defecto también es paused, y solo se activa si envías status active.

¿Puedo duplicar una campaña creada fuera de Connect?

Sí, siempre que el id sea de un objeto de la cuenta conectada. El id numérico de la plataforma sirve para cualquier objeto de la cuenta.

¿Y si repito la llamada por error?

Con el mismo Idempotency-Key, la repetición devuelve la respuesta de la primera y no crea otra copia.

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.