Synup
Créer une clé
v1Ressources/Paid Boosts/postCreate a boost

Create a boost

Boosts a post with paid ad spend through a connected ad account. This spends real money, so a budget and a duration are always required: a saved boost config only supplies defaults, never a budget. Pass postSubmissionId to boost an already-published post now, or postId with platform or connectionId to queue a boost that starts once the post goes live. A daily budget above 500,000 minor units or a duration over 90 days is refused.

post/api/v1/boosts
boosts:write
Corps de la requête
postSubmissionIdstringfacultatif
An already-published post's submission id. Use this or postId, not both.
postIdstringfacultatif
A not-yet-published post's id. Needs platform or connectionId.
platformstringfacultatif
Which platform submission to boost when using postId, for example facebook.
connectionIdstringfacultatif
The exact connection to boost when using postId. Preferred over platform.
boostConfigIdstringfacultatif
A saved boost config to take the ad account, targeting, publisher platforms and delay from. Its budget is not used.
adAccountIdstringfacultatif
The ad account to spend from. Required unless the boost config supplies one.
targetingobjectfacultatif
The audience targeting.
dailyBudgetintegerobligatoire
The daily budget in minor currency units, for example 2500 for 25.00 a day. Greater than 0 and at most 500,000.
durationDaysintegerobligatoire
How many days the boost runs, 1 to 90.
delayHoursnumberfacultatif
Hours to wait after the post goes live before spend starts.
publisherPlatformsarray of stringfacultatif
Platform surfaces to run on, for example facebook and instagram.
scheduledStartstringfacultatif
An exact date-time to start spend at, instead of a delay.
Réponse
dataobjectfacultatif
adRunIdstringfacultatif
The new boost's id.
adSetIdstringfacultatif
Its ad set's id.
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/boosts
Votre clé API
Corps de la requête*
{
  "data": {
    "adRunId": "run_123",
    "adSetId": "set_123"
  }
}

Vous débutez avec l'API Synup ?