Synupv1
Crear clave
v1Recursos/Connections/getListar cuentas conectadas

Listar cuentas conectadas

Devuelve las cuentas conectadas de publishers/redes sociales de su agencia (Google, Facebook, Instagram, LinkedIn, TikTok y otras), opcionalmente filtradas por cliente o plataforma.

get/api/v1/connections
connections:read
Parámetros de consulta
clientIdstringopcional
Restringe los resultados a un cliente. Cuando su clave está limitada a clientes específicos, los resultados siempre se prefiltran a esos clientes aunque se omita esto.
platformstringopcional
Restringe los resultados a una plataforma, p. ej. facebook, google.
credentialsValidbooleanopcional
Restringe a cuentas cuyas credenciales almacenadas son (true) o no son (false) válidas actualmente.
fetchStatusstringopcional
Restringe a cuentas con este estado de sincronización.
cursorstringopcional
Cursor de paginación tomado del nextCursor de una respuesta anterior.
limitintegeropcional
Máximo de cuentas a devolver, de 1 a 100. El valor predeterminado es 20.
Respuesta
dataobjectopcional
accountsarray of objectopcional
Las cuentas conectadas que coinciden.
idstringopcional
Identificador único de la cuenta conectada.
platformstringopcional
La plataforma a la que se conecta esta cuenta, p. ej. google, facebook, instagram.
displayNamestringopcional
Nombre visible de la cuenta conectada.
providerAccountIdstringopcional
El identificador propio de la plataforma para esta cuenta.
credentialsValidbooleanopcional
Si las credenciales almacenadas son válidas actualmente.
fetchStatusstringopcional
Estado de sincronización actual de esta cuenta, p. ej. idle, fetching.
fetchErrorstringopcional
El último mensaje de error de sincronización, o null.
errorTagstringopcional
Un código de error breve legible por máquina, o null.
gmbGroupIdsarray of stringopcional
IDs de grupo de Google Business Profile asociados a esta cuenta, si los hay.
expiresAtstringopcional
Cuándo expira el token de acceso de esta cuenta, como marca de tiempo ISO 8601, o null.
dataAccessExpiresAtstringopcional
Cuándo expira la ventana de acceso a datos de Meta para esta cuenta, como marca de tiempo ISO 8601, o null.
channelstringopcional
El canal a través del cual se hizo esta conexión.
clientIdstringopcional
ID del cliente al que pertenece esta cuenta, o null para una conexión de toda la agencia.
synupLocationIdstringopcional
Identificador de ubicación heredado. Obsoleto — prefiera clientLocationId.
clientLocationIdstringopcional
ID de la ubicación a la que está vinculada esta cuenta, o null. Prefiera este a synupLocationId.
fetchedListingsCountnumberopcional
Número de listados que ha sincronizado esta cuenta.
lastFetchedAtstringopcional
Cuándo completó esta cuenta su última sincronización, como marca de tiempo ISO 8601, o null.
connectionStatusstring (CONNECTED | MISSING | RENEW | DISCONNECTED | SUSPENDED | SUGGESTED_MATCH)opcional
Estado general de esta conexión: CONNECTED, MISSING, RENEW, DISCONNECTED, SUSPENDED o SUGGESTED_MATCH.
createdAtstringopcional
Cuándo se conectó esta cuenta, como marca de tiempo ISO 8601.
updatedAtstringopcional
Cuándo se actualizó por última vez esta cuenta, como marca de tiempo ISO 8601.
nextCursorstringopcional
Cursor de paginación para la siguiente página, o null cuando no hay más resultados.
totalCountnumberopcional
Número total de cuentas que coinciden con la solicitud.
Errores
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.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/connections
Su clave de API
clientId
platform
credentialsValid
fetchStatus
cursor
limit
{
  "data": {
    "accounts": [
      {
        "id": "conn_1",
        "platform": "google",
        "displayName": "Acme Dental — Google",
        "providerAccountId": "112233445566",
        "credentialsValid": true,
        "fetchStatus": "ok",
        "fetchError": null,
        "errorTag": null,
        "gmbGroupIds": [],
        "expiresAt": null,
        "dataAccessExpiresAt": "2026-05-01T00:00:00.000Z",
        "channel": "local",
        "clientId": "cli_123",
        "synupLocationId": null,
        "clientLocationId": "loc_456"
      }
    ],
    "nextCursor": null,
    "totalCount": 1
  }
}