Versões e mudanças

A v1 é estável. Novos campos e rotas podem aparecer sem aviso: ignore o que não conhece. Evitamos mudanças que quebram integração na v1; quando uma é inevitável, ela aparece em destaque na lista abaixo, com a data.

• 1.2.0 (30/10/2026): "Eventos do site" em todo anúncio novo, com o Pixel obrigatório: tracking.pixel_id passa a valer em qualquer objetivo (antes, só nas conversões) e, sem ele, vale o Pixel padrão da conta ou o único que ela enxerga, que vira o padrão. Três mudanças de comportamento: sem Pixel para escolher (a conta tem vários e nenhum padrão, não tem nenhum, ou a consulta dos Pixels falhou), POST /campaigns, POST /campaigns/preview, POST /templates/{id}/campaigns, POST /campaigns/{id}/duplicate e POST /boosts passam a recusar com 422 em tracking.pixel_id, também com ?validate_only=true (antes, o anúncio saía sem "Eventos do site"), e POST /campaigns/{id}/retry, com operation_failed; o draft, o boost (que passa a aceitar tracking.pixel_id) e o validate_only passam a mostrar em tracking.pixel_id o Pixel escolhido, em todo objetivo; e os 4 UTMs padrão, com os extras de tracking.url_tags, passam a ir também nos anúncios de WhatsApp, de cadastro e de post impulsionado (antes, só nos com link). Anúncios já publicados não mudam.
• 1.1.0 (29/10/2026): arte, vídeo e carrossel na mesma campanha (creatives[].cards; o formato antigo segue aceito); padrões e duplicação com carrossel; prévia de qualquer anúncio da campanha; "Eventos do site" e os 4 UTMs padrão em todo anúncio novo com link (anúncios já publicados não mudam); PATCH /templates/{id} edita o padrão por completo, menos o objetivo e a conta de anúncio (os campos de POST /templates/{id}/campaigns e duration_days; a mídia pode faltar, e um media_id vira mídia guardada; com ?validate_only=true, só confere). Cinco mudanças de comportamento: tracking.url_tags passa a ser a lista de extras, somados aos 4 UTMs padrão, que vão sempre (um extra com a chave de um deles troca o valor dele; antes, iam só os enviados); em POST /templates/{id}/campaigns com creatives, só saem os anúncios enviados ({} mantém um do padrão); em POST /templates/{id}/campaigns de um padrão com persona, as exclusões, os idiomas e o Advantage+ guardados no padrão passam a valer junto do público dela (o Advantage+ sai sozinho quando a persona tem grupos de interesses; antes, só o público da conta), e persona_id null usa o público guardado no padrão (antes, o Brasil, de 18 a 65 anos); em POST /campaigns/{id}/duplicate, media_id ou template_media_index num criativo ou num cartão passa a ser recusado (antes era ignorado); em POST /campaigns e POST /campaigns/preview, o título, o texto, a descrição e o botão que faltarem num criativo depois do primeiro passam a vir do primeiro (antes, a descrição ficava vazia e o botão era LEARN_MORE). Para não herdar, envie o campo no próprio item: "description": null deixa o anúncio sem descrição e "call_to_action": null volta ao botão LEARN_MORE.
• 1.0.0 (28/10/2026): primeira versão pública. Campanhas (com carrossel, variações de texto, prévia e impulsionar post), conjuntos e anúncios, mídias, personas e padrões, públicos de remarketing, métricas e relatórios, leads, Gestor IA, saúde e alertas da conta, rascunho pela IA e webhooks.

Especificação OpenAPI 3.1 para importar no Postman ou no Insomnia, ou para gerar um SDK: https://leadgo.com.br/docs/api/openapi.json.