Synupv1
Crear clave
v1Recursos/Connections/getListar cuentas publicitarias

Listar cuentas publicitarias

Devuelve las cuentas publicitarias de social pagado disponibles en una cuenta conectada (Facebook, Instagram, LinkedIn o TikTok).

get/api/v1/connections/ad-accounts
connections:read
Parámetros de consulta
connectionIdstringobligatorio
La cuenta conectada a consultar. 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.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/connections/ad-accounts
Su clave de API
connectionId *
{
  "data": {
    "adAccounts": [
      {
        "id": "adacct_1",
        "connectionId": "conn_1",
        "platformAccountId": "act_549988676430053",
        "name": "Acme Dental Ads",
        "platform": "facebook",
        "status": "active",
        "isSelected": true,
        "currency": "USD",
        "archived": false,
        "createdAt": "2026-01-15T10:00:00.000Z",
        "updatedAt": "2026-01-15T10:00:00.000Z"
      }
    ]
  }
}