Synupv1
Schlüssel erstellen
v1Ressourcen/Connections/postBoost-Konfiguration aktualisieren

Boost-Konfiguration aktualisieren

Bearbeitet eine bestehende, nicht archivierte Boost-Konfiguration. Nur die von Ihnen angegebenen Felder werden geändert.

post/api/v1/connections/boost-configs/update
connections:write
Anfragetext
connectionIdstringerforderlich
Das verbundene Konto, dem die Boost-Konfiguration gehört. Erforderlich. Nachschlagen mit GET /api/v1/connections.
configIdstringerforderlich
Die zu aktualisierende Boost-Konfiguration. Muss zu connectionId gehören und darf nicht archiviert sein. Erforderlich.
adAccountIdstringoptional
Neues Werbekonto, aus dem ausgegeben werden soll, falls geändert.
namestringoptional
Neuer Name für diese Vorlage, falls geändert.
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).
dailyBudgetnumberoptional
Neues Tagesbudget, in der kleinsten Währungseinheit der Plattform, falls geändert.
durationDaysnumberoptional
Neue Laufzeit in Tagen, falls geändert.
delayHoursnumberoptional
Neue Verzögerung in Stunden vor dem Boosten, falls geändert.
publisherPlatformsarray of stringoptional
Neue Liste der Plattform-Oberflächen zum Boosten, falls geändert.
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/update
Ihr API-Schlüssel
Anfragetext*
{
  "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"
    }
  }
}