Synup
Schlüssel erstellen
v1Ressourcen/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
Anfragetext
postSubmissionIdstringoptional
An already-published post's submission id. Use this or postId, not both.
postIdstringoptional
A not-yet-published post's id. Needs platform or connectionId.
platformstringoptional
Which platform submission to boost when using postId, for example facebook.
connectionIdstringoptional
The exact connection to boost when using postId. Preferred over platform.
boostConfigIdstringoptional
A saved boost config to take the ad account, targeting, publisher platforms and delay from. Its budget is not used.
adAccountIdstringoptional
The ad account to spend from. Required unless the boost config supplies one.
targetingobjectoptional
The audience targeting.
dailyBudgetintegererforderlich
The daily budget in minor currency units, for example 2500 for 25.00 a day. Greater than 0 and at most 500,000.
durationDaysintegererforderlich
How many days the boost runs, 1 to 90.
delayHoursnumberoptional
Hours to wait after the post goes live before spend starts.
publisherPlatformsarray of stringoptional
Platform surfaces to run on, for example facebook and instagram.
scheduledStartstringoptional
An exact date-time to start spend at, instead of a delay.
Antwort
dataobjectoptional
adRunIdstringoptional
The new boost's id.
adSetIdstringoptional
Its ad set's id.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/boosts
Ihr API-Schlüssel
Anfragetext*
{
  "data": {
    "adRunId": "run_123",
    "adSetId": "set_123"
  }
}

Neu bei der Synup-API?