Synupv1
Crear clave
v1Recursos/Connections/postSincronizar cuentas publicitarias

Sincronizar cuentas publicitarias

Fuerza una nueva sincronización inmediata de las cuentas publicitarias de una cuenta conectada desde la plataforma, en lugar de esperar la sincronización diaria en segundo plano. Devuelve la lista actualizada.

post/api/v1/connections/ad-accounts/sync
connections:write
Cuerpo de la solicitud
connectionIdstringobligatorio
La cuenta conectada a sincronizar. Obligatorio. Búsquelo con GET /api/v1/connections.
Respuesta
dataobjectopcional
adAccountsarray of objectopcional
Las cuentas publicitarias disponibles en esta cuenta conectada.
idstringopcional
Identificador único de la cuenta publicitaria.
connectionIdstringopcional
ID de la cuenta conectada a la que pertenece esta cuenta publicitaria.
platformAccountIdstringopcional
El identificador propio de la plataforma para esta cuenta publicitaria, p. ej. act_226123609900306 para Meta.
namestringopcional
Nombre visible de la cuenta publicitaria.
platformstringopcional
Plataforma a la que pertenece esta cuenta publicitaria: facebook, instagram, linkedin o tiktok.
statusstring (active | disabled | unsettled | pending_review)opcional
Estado informado por la plataforma: active, disabled, unsettled o pending_review.
isSelectedbooleanopcional
Si esta es la cuenta publicitaria actualmente seleccionada para promocionar en esta conexión.
currencystringopcional
Moneda en la que factura esta cuenta publicitaria, o null.
archivedbooleanopcional
Si esta cuenta publicitaria ha sido archivada.
createdAtstringopcional
Cuándo se sincronizó por primera vez esta cuenta publicitaria, como marca de tiempo ISO 8601.
updatedAtstringopcional
Cuándo se sincronizó por última vez esta cuenta publicitaria, como marca de tiempo ISO 8601.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
422A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
post/api/v1/connections/ad-accounts/sync
Su clave de API
Cuerpo de la solicitud*
{
  "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"
      }
    ]
  }
}