Ads
Duplicar anúncio, conjunto ou campanha no Meta Ads pela API
Clone um anúncio, um conjunto ou uma campanha da conta do cliente sem remontar tudo. Você pode ajustar nome, orçamento, agenda ou a campanha de destino na própria chamada. A cópia nasce pausada, então nada gasta até você ativar.
A chamada
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"
}O que dá para fazer
- Duplicar um anúncio com POST /ads/{id}/duplicate.
- Duplicar um conjunto com POST /ads/adsets/{id}/duplicate, escolhendo outra campanha de destino com campaign_id.
- Duplicar uma campanha com POST /ads/campaigns/{id}/duplicate.
- Mudar o nome da cópia e, em conjunto e campanha, o orçamento.
- Mudar a data de início de um conjunto copiado.
- Usar o id numérico da plataforma ou o uuid do Connect.
Regras e limites
- Idempotency-Key é obrigatório no header; repetir com a mesma chave devolve 200 com Idempotent-Replay: true, sem criar outra cópia.
- A cópia de um anúncio é sempre criada pausada, no mesmo conjunto. Em conjunto e campanha, status é paused por padrão.
- name é obrigatório ao duplicar conjunto e campanha, e opcional ao duplicar anúncio.
- O orçamento segue a regra CBO/ABO: mandar para o nível errado responde 409 budget_level_mismatch.
- O objeto precisa existir na conta da conexão; id de outra conta responde 404 ads_object_not_found.
- A resposta é síncrona (201).
Campos principais
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| id | string | Sim | No caminho: o id do anúncio, conjunto ou campanha a copiar (ou o uuid do Connect). |
| name | string | Sim | Nome da cópia. Opcional ao duplicar um anúncio (sem nome, a plataforma atribui um); obrigatório para conjunto e campanha. |
| status | string | Não | Só em conjunto e campanha: paused (padrão) ou active. |
| campaign_id | string | Não | Só em conjunto: a campanha de destino. Sem ele, a cópia fica na campanha de origem. |
| budget.amount | number | Não | Só em conjunto e campanha: novo orçamento, na moeda da conta. |
| schedule.start | string | Não | Só em conjunto: nova data de início. |
Para quem
Escalar o que funciona
Duplique um conjunto vencedor com um orçamento maior ou outra campanha de destino, e ative quando estiver pronto.
Testes de criativo
Copie um anúncio e depois altere o texto ou o título da cópia para comparar variações.
Templates por cliente
Mantenha uma campanha modelo e duplique-a para cada novo cliente, mudando só o nome e o orçamento.
Funciona com
Meta Ads
Perguntas frequentes
A cópia começa gastando?
A cópia de um anúncio nasce sempre pausada. Para conjunto e campanha o padrão também é paused, e você só ativa se enviar status active.
Posso duplicar uma campanha criada fora do Connect?
Sim, desde que o id seja de um objeto da conta conectada. O id numérico da plataforma funciona para qualquer objeto da conta.
E se eu repetir a chamada por engano?
Com o mesmo Idempotency-Key, a repetição devolve a resposta da primeira e não cria outra cópia.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
