Synup
Schlüssel erstellen
v1Ressourcen/Connections/getWerbekonten auflisten

Werbekonten auflisten

Liefert die auf einem verbundenen Konto verfügbaren Paid-Social-Werbekonten (Facebook, Instagram, LinkedIn oder TikTok).

get/api/v1/connections/ad-accounts
connections:read
Query-Parameter
connectionIdstringerforderlich
Das abzurufende 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.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/connections/ad-accounts
Ihr API-Schlüssel
connectionId *
{
  "data": {
    "adAccounts": [
      {
        "id": "adacct_1",
        "connectionId": "conn_1",
        "platformAccountId": "act_549988676430053",
        "name": "Acme Dental Ads",
        "platform": "facebook",
        "status": "active",
        "isSelected": true,
        "currency": "USD",
        "archived": false,
        "createdAt": "2026-01-15T10:00:00.000Z",
        "updatedAt": "2026-01-15T10:00:00.000Z"
      }
    ]
  }
}

Anleitungen, die diese Ressource verwenden