v1Recursos/Connections/postCrear una configuración de promoción
Crear una configuración de promoción
Guarda una nueva configuración de promoción reutilizable (segmentación, presupuesto diario y duración) en la cuenta publicitaria de una cuenta conectada. Esto solo almacena una plantilla para usarla más adelante — no promociona una publicación por sí sola, no envía nada a la plataforma publicitaria, ni gasta dinero. El dinero solo se gasta cuando esta configuración guardada se aplica más adelante para promocionar una publicación específica.
post
connections:write/api/v1/connections/boost-configsCuerpo de la solicitud
connectionIdstringobligatorio
La cuenta conectada a la que asociar esta configuración de promoción. Obligatorio. Búsquelo con GET /api/v1/connections.
adAccountIdstringobligatorio
La cuenta publicitaria de la que se gastará cuando se use esta configuración. Debe pertenecer a connectionId. Obligatorio.
namestringobligatorio
Un nombre para esta plantilla, que se muestra al elegirla más adelante. Obligatorio.
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).
dailyBudgetnumberobligatorio
Presupuesto diario, en la unidad monetaria menor de la plataforma (p. ej. centavos). Debe ser positivo. Obligatorio.
durationDaysnumberobligatorio
Cuántos días debe ejecutarse la promoción una vez aplicada. Debe ser positivo. Obligatorio.
delayHoursnumberopcional
Horas a esperar después de publicar una publicación antes de promocionarla. El valor predeterminado es 0.
publisherPlatformsarray of stringopcional
En qué superficies de plataforma promocionar, p. ej. ["facebook", "instagram"].
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
Su clave de API
Cuerpo de la solicitud*
{
"data": {
"boostConfig": {
"id": "boost_1",
"connectionId": "conn_1",
"adAccountId": "adacct_1",
"name": "Local awareness — $10/day",
"platform": "facebook",
"targeting": {
"ageMin": 25,
"ageMax": 55,
"genders": [],
"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"
}
}
}