Synupv1
Schlüssel erstellen
v1Ressourcen/Connections/postWerbekonten synchronisieren

Werbekonten synchronisieren

Erzwingt einen sofortigen erneuten Abruf der Werbekonten eines verbundenen Kontos von der Plattform, statt auf die tägliche Hintergrundsynchronisierung zu warten. Liefert die aktualisierte Liste zurück.

post/api/v1/connections/ad-accounts/sync
connections:write
Anfragetext
connectionIdstringerforderlich
Das zu synchronisierende verbundene Konto. Erforderlich. Nachschlagen mit GET /api/v1/connections.
Antwort
dataobjectoptional
adAccountsarray of objectoptional
Die auf diesem verbundenen Konto verfügbaren Werbekonten.
idstringoptional
Eindeutige Kennung des Werbekontos.
connectionIdstringoptional
ID des verbundenen Kontos, zu dem dieses Werbekonto gehört.
platformAccountIdstringoptional
Die eigene Kennung der Plattform für dieses Werbekonto, z. B. act_226123609900306 für Meta.
namestringoptional
Anzeigename des Werbekontos.
platformstringoptional
Plattform, zu der dieses Werbekonto gehört: facebook, instagram, linkedin oder tiktok.
statusstring (active | disabled | unsettled | pending_review)optional
Von der Plattform gemeldeter Status: active, disabled, unsettled oder pending_review.
isSelectedbooleanoptional
Ob dies das für diese Verbindung aktuell zum Boosten ausgewählte Werbekonto ist.
currencystringoptional
Währung, in der dieses Werbekonto abrechnet, oder null.
archivedbooleanoptional
Ob dieses Werbekonto archiviert wurde.
createdAtstringoptional
Wann dieses Werbekonto erstmals synchronisiert wurde, als ISO-8601-Zeitstempel.
updatedAtstringoptional
Wann dieses Werbekonto zuletzt synchronisiert wurde, als ISO-8601-Zeitstempel.
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.
422Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/connections/ad-accounts/sync
Ihr API-Schlüssel
Anfragetext*
{
  "data": {
    "adAccounts": [
      {
        "id": "adacct_1",
        "connectionId": "conn_1",
        "platformAccountId": "act_549988676430053",
        "name": "Acme Dental Ads",
        "platform": "facebook",
        "status": "active",
        "isSelected": false,
        "currency": "USD",
        "archived": false,
        "createdAt": "2026-01-15T10:00:00.000Z",
        "updatedAt": "2026-02-01T09:00:00.000Z"
      }
    ]
  }
}