Synupv1
Créer une clé
v1Ressources/Connexions/postMettre à jour une configuration de boost

Mettre à jour une configuration de boost

Modifie une configuration de boost existante et non archivée. Seuls les champs fournis sont modifiés.

post/api/v1/connections/boost-configs/update
connections:write
Corps de la requête
connectionIdstringobligatoire
Le compte connecté propriétaire de la configuration de boost. Obligatoire. Retrouvez-le avec GET /api/v1/connections.
configIdstringobligatoire
La configuration de boost à mettre à jour. Doit appartenir à connectionId et ne pas être archivée. Obligatoire.
adAccountIdstringfacultatif
Nouveau compte publicitaire duquel dépenser, si vous le modifiez.
namestringfacultatif
Nouveau nom pour ce préréglage, si vous le modifiez.
targetingobjectfacultatif
Tous les champs sont facultatifs. Un objet vide cible l'audience par défaut la plus large de la plateforme.
ageMinnumberfacultatif
Âge minimal de l'audience.
ageMaxnumberfacultatif
Âge maximal de l'audience.
gendersarray of numberfacultatif
Genres d'audience à cibler : 1 pour homme, 2 pour femme.
geoLocationsobjectfacultatif
Ciblage géographique : pays, régions, villes et/ou codes postaux.
countriesarray of stringfacultatif
regionsarray of objectfacultatif
keystringfacultatif
namestringfacultatif
citiesarray of objectfacultatif
keystringfacultatif
namestringfacultatif
radiusnumberfacultatif
distanceUnitstringfacultatif
zipsarray of objectfacultatif
keystringfacultatif
namestringfacultatif
interestsarray of objectfacultatif
Catégories d'intérêt à cibler.
idstringfacultatif
namestringfacultatif
publisherPlatformsarray of stringfacultatif
Sur quelles surfaces de plateforme cibler, par ex. ["facebook", "instagram"].
pageFansstring (fans | fans_of_fans)facultatif
Restreint l'audience aux personnes qui aiment la page (fans) ou aussi à leurs amis (fans_of_fans).
dailyBudgetnumberfacultatif
Nouveau budget quotidien, dans l'unité monétaire mineure de la plateforme, si vous le modifiez.
durationDaysnumberfacultatif
Nouvelle durée en jours, si vous la modifiez.
delayHoursnumberfacultatif
Nouveau délai en heures avant de booster, si vous le modifiez.
publisherPlatformsarray of stringfacultatif
Nouvelle liste de surfaces de plateforme sur lesquelles booster, si vous la modifiez.
Réponse
dataobjectfacultatif
boostConfigobjectfacultatif
idstringfacultatif
Identifiant unique de la configuration de boost.
connectionIdstringfacultatif
ID du compte connecté auquel appartient cette configuration de boost.
adAccountIdstringfacultatif
ID du compte publicitaire duquel cette configuration de boost dépense.
namestringfacultatif
Nom de ce préréglage.
platformstringfacultatif
Plateforme sur laquelle tourne cette configuration de boost, correspondant à son compte connecté.
targetingobjectfacultatif
Réglages de ciblage pour ce préréglage.
ageMinnumberfacultatif
Âge minimal de l'audience.
ageMaxnumberfacultatif
Âge maximal de l'audience.
gendersarray of numberfacultatif
Genres d'audience à cibler : 1 pour homme, 2 pour femme.
geoLocationsobjectfacultatif
Ciblage géographique : pays, régions, villes et/ou codes postaux.
interestsarray of objectfacultatif
Catégories d'intérêt à cibler.
publisherPlatformsarray of stringfacultatif
Sur quelles surfaces de plateforme cibler, par ex. ["facebook", "instagram"].
pageFansstring (fans | fans_of_fans)facultatif
Restreint l'audience aux personnes qui aiment la page (fans) ou aussi à leurs amis (fans_of_fans).
dailyBudgetnumberfacultatif
Budget quotidien, dans l'unité monétaire mineure de la plateforme (par ex. les centimes).
durationDaysnumberfacultatif
Nombre de jours pendant lesquels le boost tourne une fois appliqué.
delayHoursnumberfacultatif
Heures à attendre après la publication d'un post avant de le booster.
publisherPlatformsarray of stringfacultatif
Sur quelles surfaces de plateforme ce préréglage booste.
archivedbooleanfacultatif
Si ce préréglage a été archivé.
createdAtstringfacultatif
Date de création de ce préréglage, au format horodatage ISO 8601.
updatedAtstringfacultatif
Date de dernière mise à jour de ce préréglage, au format horodatage ISO 8601.
adAccountobjectfacultatif
Un court résumé du compte publicitaire duquel ce préréglage dépense, ou null.
platformAccountIdstringfacultatif
L'identifiant propre à la plateforme pour ce compte publicitaire.
namestringfacultatif
Nom d'affichage de ce compte publicitaire.
currencystringfacultatif
Devise de facturation de ce compte publicitaire, ou null.
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
post/api/v1/connections/boost-configs/update
Votre clé API
Corps de la requête*
{
  "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"
    }
  }
}