Synup
Schlüssel erstellen
v1Ressourcen/Connections/postBoost-Konfiguration erstellen

Boost-Konfiguration erstellen

Speichert eine neue wiederverwendbare Boost-Konfiguration (Targeting, Tagesbudget und Laufzeit) auf dem Werbekonto eines verbundenen Kontos. Dies speichert lediglich eine Vorlage für die spätere Verwendung — es boostet dabei selbst keinen Beitrag, übermittelt nichts an die Werbeplattform und gibt kein Geld aus. Geld wird erst ausgegeben, wenn diese gespeicherte Konfiguration später auf einen bestimmten Beitrag angewendet wird, um ihn zu boosten.

post/api/v1/connections/boost-configs
connections:write
Anfragetext
connectionIdstringerforderlich
Das verbundene Konto, an das diese Boost-Konfiguration angehängt werden soll. Erforderlich. Nachschlagen mit GET /api/v1/connections.
adAccountIdstringerforderlich
Das Werbekonto, aus dem ausgegeben werden soll, wenn diese Konfiguration verwendet wird. Muss zu connectionId gehören. Erforderlich.
namestringerforderlich
Ein Name für diese Vorlage, angezeigt bei der späteren Auswahl. Erforderlich.
targetingobjectoptional
Alle Felder sind optional. Ein leeres Objekt zielt auf die breiteste Standard-Zielgruppe der Plattform ab.
ageMinnumberoptional
Mindestalter der Zielgruppe.
ageMaxnumberoptional
Höchstalter der Zielgruppe.
gendersarray of numberoptional
Anzusprechende Geschlechter der Zielgruppe: 1 für männlich, 2 für weiblich.
geoLocationsobjectoptional
Geografisches Targeting: Länder, Regionen, Städte und/oder Postleitzahlen.
countriesarray of stringoptional
regionsarray of objectoptional
keystringoptional
namestringoptional
citiesarray of objectoptional
keystringoptional
namestringoptional
radiusnumberoptional
distanceUnitstringoptional
zipsarray of objectoptional
keystringoptional
namestringoptional
interestsarray of objectoptional
Anzusprechende Interessenkategorien.
idstringoptional
namestringoptional
publisherPlatformsarray of stringoptional
Auf welchen Plattform-Oberflächen die Zielgruppe angesprochen werden soll, z. B. ["facebook", "instagram"].
pageFansstring (fans | fans_of_fans)optional
Die Zielgruppe auf Personen beschränken, denen die Seite gefällt (Fans), oder zusätzlich auf deren Freunde (fans_of_fans).
dailyBudgetnumbererforderlich
Tagesbudget, in der kleinsten Währungseinheit der Plattform (z. B. Cent). Muss positiv sein. Erforderlich.
durationDaysnumbererforderlich
Wie viele Tage der Boost nach Anwendung laufen soll. Muss positiv sein. Erforderlich.
delayHoursnumberoptional
Stunden, die nach Veröffentlichung eines Beitrags gewartet werden soll, bevor er geboostet wird. Standardmäßig 0.
publisherPlatformsarray of stringoptional
Auf welchen Plattform-Oberflächen geboostet werden soll, z. B. ["facebook", "instagram"].
Antwort
dataobjectoptional
boostConfigobjectoptional
idstringoptional
Eindeutige Kennung der Boost-Konfiguration.
connectionIdstringoptional
ID des verbundenen Kontos, zu dem diese Boost-Konfiguration gehört.
adAccountIdstringoptional
ID des Werbekontos, aus dem diese Boost-Konfiguration ausgibt.
namestringoptional
Name dieser Vorlage.
platformstringoptional
Plattform, auf der diese Boost-Konfiguration läuft, passend zu ihrem verbundenen Konto.
targetingobjectoptional
Targeting-Einstellungen für diese Vorlage.
ageMinnumberoptional
Mindestalter der Zielgruppe.
ageMaxnumberoptional
Höchstalter der Zielgruppe.
gendersarray of numberoptional
Anzusprechende Geschlechter der Zielgruppe: 1 für männlich, 2 für weiblich.
geoLocationsobjectoptional
Geografisches Targeting: Länder, Regionen, Städte und/oder Postleitzahlen.
interestsarray of objectoptional
Anzusprechende Interessenkategorien.
publisherPlatformsarray of stringoptional
Auf welchen Plattform-Oberflächen die Zielgruppe angesprochen werden soll, z. B. ["facebook", "instagram"].
pageFansstring (fans | fans_of_fans)optional
Die Zielgruppe auf Personen beschränken, denen die Seite gefällt (Fans), oder zusätzlich auf deren Freunde (fans_of_fans).
dailyBudgetnumberoptional
Tagesbudget, in der kleinsten Währungseinheit der Plattform (z. B. Cent).
durationDaysnumberoptional
Wie viele Tage der Boost nach Anwendung läuft.
delayHoursnumberoptional
Stunden, die nach Veröffentlichung eines Beitrags gewartet wird, bevor er geboostet wird.
publisherPlatformsarray of stringoptional
Auf welchen Plattform-Oberflächen diese Vorlage boostet.
archivedbooleanoptional
Ob diese Vorlage archiviert wurde.
createdAtstringoptional
Wann diese Vorlage erstellt wurde, als ISO-8601-Zeitstempel.
updatedAtstringoptional
Wann diese Vorlage zuletzt aktualisiert wurde, als ISO-8601-Zeitstempel.
adAccountobjectoptional
Eine kurze Zusammenfassung des Werbekontos, aus dem diese Vorlage ausgibt, oder null.
platformAccountIdstringoptional
Die eigene Kennung der Plattform für dieses Werbekonto.
namestringoptional
Anzeigename dieses Werbekontos.
currencystringoptional
Währung, in der dieses Werbekonto abrechnet, oder null.
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/connections/boost-configs
Ihr API-Schlüssel
Anfragetext*
{
  "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"
    }
  }
}

Anleitungen, die diese Ressource verwenden