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

CampoTipoObrigatórioDescrição
idstringSimNo caminho: o id do anúncio, conjunto ou campanha a copiar (ou o uuid do Connect).
namestringSimNome da cópia. Opcional ao duplicar um anúncio (sem nome, a plataforma atribui um); obrigatório para conjunto e campanha.
statusstringNãoSó em conjunto e campanha: paused (padrão) ou active.
campaign_idstringNãoSó em conjunto: a campanha de destino. Sem ele, a cópia fica na campanha de origem.
budget.amountnumberNãoSó em conjunto e campanha: novo orçamento, na moeda da conta.
schedule.startstringNãoSó 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.

Relacionadas

Ver tudo que dá para fazer em Ads

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.