Synup
Crear clave
v1Recursos/Connections/getListar configuraciones de promoción

Listar configuraciones de promoción

Devuelve las configuraciones de promoción guardadas (plantillas reutilizables de segmentación y presupuesto para promocionar una publicación) de una cuenta conectada.

get/api/v1/connections/boost-configs
connections:read
Parámetros de consulta
connectionIdstringobligatorio
La cuenta conectada a consultar. Obligatorio. Búsquelo con GET /api/v1/connections.
Respuesta
dataobjectopcional
boostConfigsarray of objectopcional
Las configuraciones de promoción guardadas en esta cuenta conectada.
idstringopcional
Identificador único de la configuración de promoción.
connectionIdstringopcional
ID de la cuenta conectada a la que pertenece esta configuración de promoción.
adAccountIdstringopcional
ID de la cuenta publicitaria de la que gasta esta configuración de promoción.
namestringopcional
Nombre de esta plantilla.
platformstringopcional
Plataforma en la que se ejecuta esta configuración de promoción, coincidente con su cuenta conectada.
targetingobjectopcional
Configuración de segmentación de esta plantilla.
ageMinnumberopcional
Edad mínima de la audiencia.
ageMaxnumberopcional
Edad máxima de la audiencia.
gendersarray of numberopcional
Géneros de audiencia a segmentar: 1 para masculino, 2 para femenino.
geoLocationsobjectopcional
Segmentación geográfica: países, regiones, ciudades y/o códigos postales.
interestsarray of objectopcional
Categorías de interés a segmentar.
publisherPlatformsarray of stringopcional
Qué superficies de plataforma segmentar, p. ej. ["facebook", "instagram"].
pageFansstring (fans | fans_of_fans)opcional
Restringe la audiencia a las personas a las que les gusta la página (fans) o también a sus amigos (fans_of_fans).
dailyBudgetnumberopcional
Presupuesto diario, en la unidad monetaria menor de la plataforma (p. ej. centavos).
durationDaysnumberopcional
Cuántos días se ejecuta la promoción una vez aplicada.
delayHoursnumberopcional
Horas a esperar después de publicar una publicación antes de promocionarla.
publisherPlatformsarray of stringopcional
En qué superficies de plataforma promociona esta plantilla.
archivedbooleanopcional
Si esta plantilla ha sido archivada.
createdAtstringopcional
Cuándo se creó esta plantilla, como marca de tiempo ISO 8601.
updatedAtstringopcional
Cuándo se actualizó por última vez esta plantilla, como marca de tiempo ISO 8601.
adAccountobjectopcional
Un resumen breve de la cuenta publicitaria de la que gasta esta plantilla, o null.
platformAccountIdstringopcional
El identificador propio de la plataforma para esa cuenta publicitaria.
namestringopcional
Nombre visible de esa cuenta publicitaria.
currencystringopcional
Moneda en la que factura esa cuenta publicitaria, o null.
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/boost-configs
Su clave de API
connectionId *
{
  "data": {
    "boostConfigs": [
      {
        "id": "boost_1",
        "connectionId": "conn_1",
        "adAccountId": "adacct_1",
        "name": "Local awareness — $10/day",
        "platform": "facebook",
        "targeting": {
          "ageMin": 25,
          "ageMax": 55,
          "genders": [],
          "geoLocations": {
            "countries": [],
            "regions": [],
            "cities": [],
            "zips": []
          },
          "interests": [],
          "publisherPlatforms": [
            "facebook"
          ]
        },
        "dailyBudget": 10,
        "durationDays": 7,
        "delayHours": 0,
        "publisherPlatforms": [
          "facebook"
        ],
        "archived": false,
        "createdAt": "2026-01-15T10:00:00.000Z",
        "updatedAt": "2026-01-15T10:00:00.000Z"
      }
    ]
  }
}

Guías que usan este recurso