Synupv1
Créer une clé
v1Ressources/Connexions/postCréer une configuration de boost

Créer une configuration de boost

Enregistre une nouvelle configuration de boost réutilisable (ciblage, budget quotidien et durée) sur le compte publicitaire d'un compte connecté. Ceci ne fait que stocker un préréglage pour un usage ultérieur — cela ne booste pas un post en soi, ne soumet rien à la plateforme publicitaire, et ne dépense aucun argent. L'argent n'est dépensé que lorsque cette configuration enregistrée est ensuite appliquée pour booster un post spécifique.

post/api/v1/connections/boost-configs
connections:write
Corps de la requête
connectionIdstringobligatoire
Le compte connecté auquel attacher cette configuration de boost. Obligatoire. Retrouvez-le avec GET /api/v1/connections.
adAccountIdstringobligatoire
Le compte publicitaire duquel dépenser quand cette configuration est utilisée. Doit appartenir à connectionId. Obligatoire.
namestringobligatoire
Un nom pour ce préréglage, affiché lors de sa sélection ultérieure. Obligatoire.
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).
dailyBudgetnumberobligatoire
Budget quotidien, dans l'unité monétaire mineure de la plateforme (par ex. les centimes). Doit être positif. Obligatoire.
durationDaysnumberobligatoire
Nombre de jours pendant lesquels le boost doit tourner une fois appliqué. Doit être positif. Obligatoire.
delayHoursnumberfacultatif
Heures à attendre après la publication d'un post avant de le booster. Par défaut 0.
publisherPlatformsarray of stringfacultatif
Sur quelles surfaces de plateforme booster, par ex. ["facebook", "instagram"].
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
Votre clé API
Corps de la requête*
{
  "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"
    }
  }
}