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
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | string | Sí | En la ruta: el id del anuncio, conjunto o campaña a copiar (o el uuid de Connect). |
| name | string | Sí | Nombre de la copia. Opcional al duplicar un anuncio (sin nombre, la plataforma asigna uno); obligatorio para conjunto y campaña. |
| status | string | No | Solo en conjunto y campaña: paused (por defecto) o active. |
| campaign_id | string | No | Solo en conjunto: la campaña de destino. Sin él, la copia queda en la campaña de origen. |
| budget.amount | number | No | Solo en conjunto y campaña: nuevo presupuesto, en la moneda de la cuenta. |
| schedule.start | string | No | Solo 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.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
