Synupv1
Crear clave
v1Recursos/Connections/postActualizar una configuración de promoción

Actualizar una configuración de promoción

Edita una configuración de promoción existente y no archivada. Solo se modifican los campos que usted indique.

post/api/v1/connections/boost-configs/update
connections:write
Cuerpo de la solicitud
connectionIdstringobligatorio
La cuenta conectada propietaria de la configuración de promoción. Obligatorio. Búsquelo con GET /api/v1/connections.
configIdstringobligatorio
La configuración de promoción a actualizar. Debe pertenecer a connectionId y no estar archivada. Obligatorio.
adAccountIdstringopcional
Nueva cuenta publicitaria de la que gastar, si se cambia.
namestringopcional
Nuevo nombre para esta plantilla, si se cambia.
targetingobjectopcional
Todos los campos son opcionales. Un objeto vacío segmenta la audiencia predeterminada más amplia de la plataforma.
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.
countriesarray of stringopcional
regionsarray of objectopcional
keystringopcional
namestringopcional
citiesarray of objectopcional
keystringopcional
namestringopcional
radiusnumberopcional
distanceUnitstringopcional
zipsarray of objectopcional
keystringopcional
namestringopcional
interestsarray of objectopcional
Categorías de interés a segmentar.
idstringopcional
namestringopcional
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
Nuevo presupuesto diario, en la unidad monetaria menor de la plataforma, si se cambia.
durationDaysnumberopcional
Nueva duración en días, si se cambia.
delayHoursnumberopcional
Nuevo retraso en horas antes de promocionar, si se cambia.
publisherPlatformsarray of stringopcional
Nueva lista de superficies de plataforma en las que promocionar, si se cambia.
Respuesta
dataobjectopcional
boostConfigobjectopcional
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.
post/api/v1/connections/boost-configs/update
Su clave de API
Cuerpo de la solicitud*
{
  "data": {
    "boostConfig": {
      "id": "boost_1",
      "connectionId": "conn_1",
      "adAccountId": "adacct_1",
      "name": "Local awareness — $15/day",
      "platform": "facebook",
      "targeting": {
        "ageMin": 25,
        "ageMax": 55,
        "genders": [],
        "publisherPlatforms": [
          "facebook"
        ]
      },
      "dailyBudget": 15,
      "durationDays": 7,
      "delayHours": 0,
      "publisherPlatforms": [
        "facebook"
      ],
      "archived": false,
      "createdAt": "2026-01-15T10:00:00.000Z",
      "updatedAt": "2026-02-01T09:00:00.000Z"
    }
  }
}