Ads
Pausar e ativar campanhas, conjuntos e anúncios pela API
Ligar e desligar anúncios é um PATCH com status active ou paused, no nível que você quer controlar: campanha, conjunto ou anúncio. Funciona para qualquer objeto da conta conectada, inclusive os criados direto no Gerenciador de Anúncios. Sem implementar a API do Meta.
A chamada
PATCH /api/ads/campaigns/{id}?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>
{
"status": "active"
}O que dá para fazer
- Pausar ou ativar uma campanha com PATCH /ads/campaigns/{id}.
- Pausar ou ativar um conjunto com PATCH /ads/adsets/{id}.
- Pausar ou ativar um anúncio com PATCH /ads/{id}.
- Trocar o nome no mesmo PATCH.
- Identificar o objeto pelo id da plataforma ou pelo uuid do Connect.
Regras e limites
- Valores aceitos em status: active e paused.
- Funciona para qualquer objeto da conta, inclusive criados fora do Connect: ele passa a ser guardado na primeira escrita.
- Idempotency-Key é opcional em PATCH.
- O id é conferido contra a conta da conexão; de outra conta, a resposta é 404 ads_object_not_found.
- A conexão em customer_integration precisa pertencer ao cliente (403 se não pertencer) e estar válida (422 ads_connection_expired se o token expirou).
- A resposta é síncrona (200).
Campos principais
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| id | string | Sim | No caminho: o id do objeto (ou o uuid do Connect). |
| status | string | Não | active ou paused. |
| name | string | Não | Novo nome, se quiser mudar junto. |
| customer_integration | string | Sim | Na query: a conexão do cliente com a conta de anúncios. |
| Idempotency-Key | string | Não | No header. Opcional em PATCH, recomendado para poder repetir com segurança. |
Para quem
Botão liga/desliga no painel
Seu cliente pausa uma campanha direto no seu produto, sem abrir o Gerenciador de Anúncios.
Regra automática de segurança
Pause anúncios quando uma métrica passar de um limite que você define, como custo por resultado alto.
Agente de IA que gerencia verba
O agente pausa o que performa mal e ativa o que foi aprovado, tudo por chamadas simples.
Funciona com
Meta Ads
Perguntas frequentes
Preciso ter criado o anúncio pelo Connect para pausá-lo?
Não. Qualquer objeto da conta conectada pode ser pausado ou ativado; ele entra na base do Connect na primeira escrita.
Quais valores de status são aceitos?
active e paused.
Posso repetir a chamada com segurança?
Sim. Envie um Idempotency-Key (opcional em PATCH) e a repetição com a mesma chave devolve a resposta da primeira.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
