Erros

O formato único dos erros e todos os códigos que a API responde.

https://leadgo.com.br/api/v1 Baixar arquivo para IA OpenAPI 3.1 Criar token

Formato e códigos

Erros vêm com o status HTTP certo e um corpo de formato único. Trate pelo code, que é estável; message pode mudar de texto. Na validação (422), errors traz as mensagens por campo.

422 Unprocessable Content

{
    "message": "O orçamento diário mínimo desta conta é R$ 6,00 (600 centavos).",
    "code": "validation_failed",
    "errors": {
        "budget.amount_cents": [
            "O orçamento diário mínimo desta conta é R$ 6,00 (600 centavos)."
        ]
    },
    "request_id": "req_01jbz7m3q7t1x5b9f3j7n1r5v9"
}

code	HTTP	Quando
token_invalid	401	Sem o cabeçalho Authorization ou com um token que não existe.
token_revoked	401	O token foi revogado no painel.
token_expired	401	O token passou da validade. Gere outro no painel.
tenant_suspended	403	A conta (ou a agência que a gerencia) está suspensa.
subscription_inactive	402	A conta não tem um plano ativo.
payment_overdue	402	Há uma fatura vencida além da carência.
token_owner_lost_access	403	Quem criou o token saiu da conta ou perdeu o acesso a ela.
missing_ability	403	O token não tem o escopo exigido pela rota (veja details.ability).
permission_denied	403	Quem criou o token não tem a permissão equivalente no painel.
not_found	404	O recurso não existe nesta conta.
validation_failed	422	Campos inválidos; o detalhe de cada um vem em errors.
rate_limited	429	Passou de 120 requisições por minuto. Espere o Retry-After.
platform_quota_exceeded	429	Muitas consultas novas à plataforma (buscas e métricas fora do cache).
ad_account_not_linked	409	A conta ainda não vinculou uma conta de anúncio da Meta.
campaign_not_published	409	A campanha ainda não está na plataforma.
campaign_not_toggleable	409	O status atual não permite ligar nem pausar.
not_toggleable	409	O status atual do conjunto ou do anúncio não permite ligar nem pausar.
ad_not_published	409	O anúncio ainda não está na plataforma.
ad_media_not_supported	422	Anúncio de vídeo: pela API, troque só texto, link, botão e UTMs.
boost_creative_locked	422	Anúncio de post impulsionado: o criativo é o próprio post e não muda pela API.
preview_unavailable	422	A prévia da Meta vale para anúncios com imagem e link (não para vídeo nem WhatsApp).
campaign_publishing	409	A campanha está sendo publicada; aguarde terminar.
campaign_not_duplicable	409	Só campanhas criadas pelo LeadGo podem ser duplicadas.
ad_account_changed	409	A campanha é de uma conta de anúncio que não está mais vinculada.
too_many_publishing	429	Já há 5 campanhas sendo publicadas nesta conta.
campaign_creation_limit	429	Passou de 30 campanhas criadas por hora.
idempotency_key_invalid	400	A Idempotency-Key tem mais de 255 caracteres.
idempotency_key_reused	422	A Idempotency-Key já foi usada com outro corpo.
idempotency_in_progress	409	O pedido com esta Idempotency-Key ainda está em andamento.
media_rejected	422	O arquivo não é JPG, PNG, MP4 ou MOV, ou passa do tamanho.
too_many_imports	429	Já há 5 mídias baixando por URL nesta conta.
sync_too_soon	429	Uma sincronização foi pedida há pouco (campanhas: 5 minutos; públicos: 1 minuto). Espere o Retry-After.
campaign_not_templatable	409	Posts impulsionados, campanhas ainda publicando e importadas com um objetivo que o LeadGo não recria não viram padrão.
brain_disabled	409	O Gestor IA está desligado nas configurações da conta.
analysis_in_progress	409	Já há uma análise em andamento nesta conta; o relatório sai em instantes.
analysis_too_soon	429	Já houve uma análise pedida nesta conta na última hora.
report_not_retryable	409	Só a análise mais recente da conta, quando falhou, pode ser refeita.
report_not_decidable	409	O relatório não aceita mais decisões (já decidido, expirado ou substituído).
action_not_decidable	409	A ação já foi decidida ou é só uma sugestão.
rollback_unavailable	409	A ação não pode ser desfeita; o motivo vem em message.
audience_not_deletable	409	Público do sistema (compradores) ou criado direto na Meta: não se exclui pela API.
ai_rate_limited	429	Limite de rascunhos pela IA por hora (somado ao painel).
ai_unavailable	503	A IA não respondeu; tente de novo em instantes.
webhook_limit_reached	422	A conta já tem 5 webhooks.
operation_failed	422	Uma regra do painel impediu a operação; o motivo vem em message.
platform_rejected	422	A Meta (via Zernio) recusou o pedido; o motivo vem em message.
platform_unavailable	502	A plataforma de anúncios não respondeu. Tente de novo.
platform_rate_limited	503	A plataforma de anúncios pediu uma pausa. Espere o Retry-After.
server_error	500	Erro do nosso lado. Informe o request_id ao suporte.