Synupv1
Criar chave
v1Recursos/Connections/postSincronizar contas de anúncios

Sincronizar contas de anúncios

Força uma nova busca imediata das contas de anúncios de uma conta conectada a partir da plataforma, em vez de esperar pela sincronização diária em segundo plano. Retorna a lista atualizada.

post/api/v1/connections/ad-accounts/sync
connections:write
Corpo da solicitação
connectionIdstringobrigatório
A conta conectada a ser sincronizada. Obrigatório. Procure com GET /api/v1/connections.
Resposta
dataobjectopcional
adAccountsarray of objectopcional
As contas de anúncios disponíveis nesta conta conectada.
idstringopcional
Identificador único da conta de anúncios.
connectionIdstringopcional
ID da conta conectada à qual esta conta de anúncios pertence.
platformAccountIdstringopcional
O identificador próprio da plataforma para esta conta de anúncios, ex.: act_226123609900306 para Meta.
namestringopcional
Nome de exibição da conta de anúncios.
platformstringopcional
Plataforma à qual esta conta de anúncios pertence: facebook, instagram, linkedin ou tiktok.
statusstring (active | disabled | unsettled | pending_review)opcional
Status reportado pela plataforma: active, disabled, unsettled ou pending_review.
isSelectedbooleanopcional
Se esta é a conta de anúncios atualmente selecionada para impulsionar nesta conexão.
currencystringopcional
Moeda em que esta conta de anúncios cobra, ou null.
archivedbooleanopcional
Se esta conta de anúncios foi arquivada.
createdAtstringopcional
Quando esta conta de anúncios foi sincronizada por primeira vez, como timestamp ISO 8601.
updatedAtstringopcional
Quando esta conta de anúncios foi sincronizada por último, como timestamp ISO 8601.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
422Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
post/api/v1/connections/ad-accounts/sync
Sua chave de API
Corpo da solicitação*
{
  "data": {
    "adAccounts": [
      {
        "id": "adacct_1",
        "connectionId": "conn_1",
        "platformAccountId": "act_549988676430053",
        "name": "Acme Dental Ads",
        "platform": "facebook",
        "status": "active",
        "isSelected": false,
        "currency": "USD",
        "archived": false,
        "createdAt": "2026-01-15T10:00:00.000Z",
        "updatedAt": "2026-02-01T09:00:00.000Z"
      }
    ]
  }
}