Platforms

Plattform-Konfigurationen

Plattformspezifische Konfigurationsoptionen für fein abgestimmtes Posten auf YouTube, TikTok, Pinterest, Instagram, Facebook, LinkedIn und Google Unternehmensprofil.

Jede Plattform verfügt über einzigartige Funktionen und Einstellungen. Verwenden Sie die untenstehenden Konfigurationsobjekte beim Erstellen von Beiträgen, um das Verhalten pro Plattform anzupassen.

TikTok

Parameter	Typ	Beschreibung
`connectionId`ERFORDERLICH	`string`	Die Konto-id aus /social-accounts, für die diese Konfiguration gilt
`title`	`string`	Videotitel (max. 90 Zeichen)
`caption`	`string`	Video-Beschreibungstext (max. 2200 Zeichen)
`privacyLevel`ERFORDERLICH	`string`	PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY
`allowComments`	`boolean`	Kommentare zum Video erlauben
`allowDuet`	`boolean`	Duette erlauben
`allowStitch`	`boolean`	Stitches erlauben
`sendAsDraft`	`boolean`	Als Entwurf an die TikTok-App senden
`aiGenerated`	`boolean`	Als KI-generierten Inhalt markieren
`autoAddMusic`	`boolean`	Musik automatisch zum Video hinzufügen
`brandedContent`	`boolean`	Als Markeninhalt kennzeichnen
`brandedContentOwnBrand`	`boolean`	Als Werbung für die eigene Marke kennzeichnen

Beispiel

{
  "tiktokConfigs": [{
    "connectionId": "conn_tiktok_001",
    "title": "Product Demo",
    "privacyLevel": "PUBLIC_TO_EVERYONE",
    "allowComments": true,
    "allowDuet": false,
    "aiGenerated": false
  }]
}

YouTube

Parameter	Typ	Beschreibung
`connectionId`ERFORDERLICH	`string`	Die Konto-id aus /social-accounts, für die diese Konfiguration gilt
`postType`	`string`	VIDEO oder SHORTS
`videoTitle`	`string`	Videotitel (max. 100 Zeichen)
`tags`	`string[]`	Video-Tags zur Auffindbarkeit (max. 20)
`privacyStatus`	`string`	public, unlisted oder private
`categoryId`	`string`	YouTube-Kategorie-ID
`playlistId`	`string`	Nach dem Upload zur Playlist hinzufügen
`notifySubscribers`	`boolean`	Abonnenten benachrichtigen (Standard: aktiviert)
`allowEmbedding`	`boolean`	Einbettung auf anderen Seiten erlauben
`madeForKids`	`boolean`	Als für Kinder geeignet markieren
`aiGenerated`	`boolean`	Kennzeichnet veränderte oder synthetische Inhalte, etwa eine KI-Stimme, einen KI-Avatar oder realistisches Filmmaterial, das erzeugt oder bearbeitet wurde. YouTube zeigt am Video das Label "Veränderte oder synthetische Inhalte". Setzt status.containsSyntheticMedia. Funktioniert bei Videos und Shorts. Lassen Sie das Feld weg oder senden Sie false, wenn kein Label erscheinen soll.
`license`	`string`	youtube oder creativeCommon

Beispiel

{
  "youtubeConfigs": [{
    "connectionId": "conn_yt_001",
    "postType": "VIDEO",
    "videoTitle": "Weekly Product Update",
    "tags": ["product", "update", "tech"],
    "privacyStatus": "PUBLIC",
    "notifySubscribers": true,
    "allowEmbedding": true,
    "madeForKids": false
  }]
}

Wählen Sie das Board mit boardId oder boardName. GET /api/v1/social-accounts/:id/pinterest-boards (siehe Social-Media-Konten) listet id und Namen jedes Boards auf. Ein Board gehört zu genau einem Pinterest-Konto. Listen Sie deshalb die Boards jedes Kontos auf, auf dem Sie posten. Ein boardName wird bei der Verarbeitung der Anfrage unter den Boards des Kontos dieser Konfiguration gesucht, und der Post speichert die id des passenden Boards; der Name selbst wird weder gespeichert noch zurückgegeben. Passt ein Name zu keinem oder zu mehreren Boards, kommt eine 400 zurück, und der Pin landet nie ersatzweise auf einem anderen Board. Bei einer Sammelanfrage schlägt nur dieser Eintrag fehl. Ohne boardId und boardName landet der Pin auf einem öffentlichen Board namens AdaptlyPost, das AdaptlyPost auf dem Pinterest-Konto anlegt, sobald es zum ersten Mal gebraucht wird.

Parameter	Typ	Beschreibung
`connectionId`ERFORDERLICH	`string`	Die Konto-id aus /social-accounts, für die diese Konfiguration gilt
`boardId`	`string`	ID des Pinterest-Boards, auf das gepinnt wird. Übergeben Sie boardId oder boardName, nicht beides. Ohne beide landet der Pin auf einem öffentlichen Board namens AdaptlyPost
`boardName`	`string`	Name des Boards, auf das gepinnt wird, anstelle von boardId. Bis zu 180 Zeichen. Ein exakter Treffer gewinnt; gibt es keinen, wird ein einzelner Treffer ohne Beachtung der Groß- und Kleinschreibung verwendet. Passt der Name zu keinem oder zu mehreren Boards, kommt eine 400 zurück
`title`	`string`	Pin-Titel (max. 100 Zeichen)
`link`	`string`	Ziel-URL beim Klick auf den Pin

Beispiel

{
  "pinterestConfigs": [{
    "connectionId": "conn_pin_001",
    "boardId": "board_123",
    "title": "Summer Collection 2026",
    "link": "https://example.com/summer-collection"
  }]
}

Instagram

Parameter	Typ	Beschreibung
`connectionId`ERFORDERLICH	`string`	Die Konto-id aus /social-accounts, für die diese Konfiguration gilt
`postType`	`string`	FEED, REEL oder STORY. FEED passt zu jedem Inhaltstyp, REEL braucht VIDEO, STORY braucht IMAGE, VIDEO oder CAROUSEL; eine CAROUSEL-Story veröffentlicht jedes Element der Reihe nach als eigene Story. Jede andere Kombination liefert 400. Feed- und Reel-Videos dürfen bis zu 15 Minuten lang sein
`shareToStory`	`boolean`	Veröffentlicht dieselben Medien zusätzlich als Story neben dem FEED- oder REEL-Beitrag. Die Story ist ein eigener Eintrag in platforms mit postType STORY und gelingt, scheitert und wird unabhängig wiederholt. Sie übernimmt keine Bildunterschrift, keinen ersten Kommentar, kein Cover, keine Mitwirkenden, keinen Test und kein Audio, braucht IMAGE, VIDEO oder CAROUSEL, und ein Video darf höchstens 60 Sekunden lang sein. Wird ignoriert, wenn postType STORY ist
`trialGraduation`	`string`	Veröffentlicht das Reel als Testreel, das zuerst Nicht-Followern gezeigt wird. MANUAL: Sie teilen es in der Instagram-App mit Ihren Followern. SS_PERFORMANCE: Instagram teilt es, wenn es gut ankommt. Nur für Video-Reels; weglassen für ein normales Reel
`collaborators`	`string[]`	Bis zu 3 Instagram-Nutzernamen, die als Mitwirkende eingeladen werden (Instagram Collab). Ein führendes @ wird entfernt. Funktioniert bei Feed-Bildern, Karussells und Reels, nicht bei Storys oder Testreels. Jeder Mitwirkende nimmt die Einladung in Instagram an, bevor der Beitrag auf seinem Profil erscheint.
`userTags`	`object[]`	Bis zu 20 öffentliche Instagram-Konten, die im Medium markiert werden, jeweils { username, x, y }. Funktioniert bei einem einzelnen Bild, einem einzelnen Video (Reel) oder einer einzelnen Story, nicht bei Karussells. x und y reichen von 0 bis 1 über das Bild, ab der linken oberen Ecke, und jede Markierung auf einem Feed-Bild braucht beide. Eine Story kann sie weglassen, ein Video ignoriert sie, weil die Person auf dem ganzen Video markiert wird. Ein führendes @ wird entfernt. Lehnt Instagram eine Markierung ab, weil das Konto privat ist oder nicht existiert, wird der Beitrag ohne Markierungen veröffentlicht und instagramUntaggedUsernames listet die abgelehnten Nutzernamen.
`aiGenerated`	`boolean`	Gibt an, dass der Beitrag mit KI erstellt oder bearbeitet wurde. Instagram zeigt am Beitrag das Label "KI-Info". Funktioniert bei Bildern, Karussells, Reels und Storys, und eine Story über shareToStory bekommt das Label auch.
`audio`	`InstagramAudio`	Musik oder ein Originalaudio, das dem Reel hinzugefügt wird. Braucht contentType VIDEO, einen postType außer STORY und ein Konto mit supportsInstagramAudio: true. Siehe Instagram-Audio unten

Beispiel

{
  "contentType": "VIDEO",
  "instagramConfigs": [{
    "connectionId": "conn_ig_001",
    "postType": "REEL",
    "shareToStory": true,
    "collaborators": ["@partnerbrand"],
    "audio": {
      "audioId": "1234567890123456",
      "title": "Summer Nights",
      "artist": "The Example Band",
      "audioVolume": 60,
      "videoVolume": 100
    }
  }]
}

Instagram-Audio

Suchen Sie eine audioId mit GET /api/v1/social-accounts/:id/instagram-audio (siehe Social-Media-Konten) und übergeben Sie sie in instagramConfigs[].audio.

Parameter	Typ	Beschreibung
`audioId`ERFORDERLICH	`string`	Die audioId aus der Audiosuche
`title`	`string`	Titel des Tracks, nur zur Anzeige gespeichert (max. 255 Zeichen)
`artist`	`string`	Interpret oder Ersteller, nur zur Anzeige gespeichert (max. 255 Zeichen)
`audioVolume`	`number`	Lautstärke des hinzugefügten Audios, 1 bis 100 (Standard 100)
`videoVolume`	`number`	Lautstärke des Originaltons des Videos, 1 bis 100 (Standard 100)

Facebook

Parameter	Typ	Beschreibung
`pageId`ERFORDERLICH	`string`	Die Facebook-Seite, für die diese Konfiguration gilt, wie in pageIds angegeben
`postType`	`string`	FEED, REEL oder STORY. FEED passt zu jedem Inhaltstyp, REEL braucht VIDEO, STORY braucht IMAGE, VIDEO oder CAROUSEL; eine CAROUSEL-Story veröffentlicht jedes Element der Reihe nach als eigene Story. Jede andere Kombination liefert 400
`shareToStory`	`boolean`	Veröffentlicht dieselben Medien zusätzlich als Story neben dem FEED- oder REEL-Beitrag. Die Story ist ein eigener Eintrag in platforms mit postType STORY und gelingt, scheitert und wird unabhängig wiederholt. Sie übernimmt keine Bildunterschrift, keinen Videotitel und keinen Texthintergrund, braucht IMAGE, VIDEO oder CAROUSEL, und ein Video darf höchstens 60 Sekunden lang sein. Wird ignoriert, wenn postType STORY ist
`videoTitle`	`string`	Titel für Videobeiträge (max. 255 Zeichen)
`textFormatPresetId`	`string`	Facebook-Hintergrund für einen Textbeitrag, als numerische Facebook-ID (106018623298955 ist ein einfarbiges Lila). Nur TEXT-Beiträge ohne Medien mit höchstens 130 Zeichen, alles andere liefert 400. Links erscheinen ohne Vorschau, und lehnt Facebook den Hintergrund ab, geht der Beitrag als reiner Text raus
`imageLayout`	`string`	GRID (Standard) zeigt mehrere Bilder als Fotoraster. CAROUSEL zeigt sie als wischbare Karten, jede mit eigenem Link. Ein Karussell braucht 2 bis 5 Bilder, keine Videos, postType FEED und einen carouselCards-Eintrag pro Bild; alles andere gibt 400 zurück
`carouselCards`	`array`	Eine Karte pro Bild, in derselben Reihenfolge wie die Medien, genutzt wenn imageLayout CAROUSEL ist. Jede Karte hat link (Pflicht, http oder https), title (bis 100 Zeichen) und description (bis 200). Facebook zeigt Ihr Bild und Ihren Titel nur bei Links zu einer Website, die der Seite gehört; bei jedem anderen Link schlägt der Beitrag fehl und nennt den Grund

Parameter	Typ	Beschreibung
`connectionId`ERFORDERLICH	`string`	Die Konto-id aus /social-accounts, für die diese Konfiguration gilt
`documentTitle`	`string`	Titel eines DOCUMENT-Beitrags (max. 100 Zeichen). Standard ist der Dateiname; bei anderen Inhaltstypen ignoriert
`reshareOf`	`string`	Ein LinkedIn-Beitrag, der mit dem Beitragstext als Kommentar weitergeteilt wird: eine urn:li:share:- oder urn:li:ugcPost:-URN oder eine LinkedIn-Beitrags-URL, die eine enthält, etwa /feed/update/urn:li:share:7123/ oder der Einbettungslink des Beitrags (max. 500 Zeichen). Auf diesem Konto werden keine Medien angehängt; die anderen Plattformen des Beitrags erhalten sie weiterhin. Eine Activity-URN oder eine /posts/...-activity-...-URL gibt 400 zurück

Beispiel

{
  "contentType": "DOCUMENT",
  "mediaUrls": ["https://cdn.adaptlypost.com/.../q3-results.pdf"],
  "linkedinConnectionIds": ["conn_li_001"],
  "linkedinConfigs": [{
    "connectionId": "conn_li_001",
    "documentTitle": "Q3 results"
  }]
}

Google Unternehmensprofil

Das Google Unternehmensprofil nimmt TEXT- oder IMAGE-Beiträge mit einem JPEG- oder PNG-Bild bis 5 MB und Text bis 1500 Zeichen. Alt-Text gibt es nicht. Ein Standort ohne Konfiguration postet ein STANDARD-Update.

Parameter	Typ	Beschreibung
`connectionId`ERFORDERLICH	`string`	Die Konto-id aus /social-accounts, für die diese Konfiguration gilt
`topicType`ERFORDERLICH	`string`	STANDARD, EVENT oder OFFER. EVENT und OFFER benötigen eventTitle, eventStart und eventEnd
`callToActionType`	`string`	BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP oder CALL. CALL nutzt die Telefonnummer aus dem Unternehmensprofil
`callToActionUrl`	`string`	Ziel der Schaltfläche. Für jede Schaltfläche außer CALL erforderlich
`eventTitle`	`string`	Titel der Veranstaltung oder des Angebots
`eventStart`	`string`	Beginn in der Ortszeit des Unternehmens, als YYYY-MM-DD oder YYYY-MM-DDTHH:mm, ohne Zeitzone
`eventEnd`	`string`	Ende in der Ortszeit des Unternehmens, als YYYY-MM-DD oder YYYY-MM-DDTHH:mm, ohne Zeitzone
`offerCouponCode`	`string`	Gutscheincode, der im Angebot angezeigt wird
`offerRedeemUrl`	`string`	Link, über den Kunden das Angebot einlösen
`offerTerms`	`string`	Bedingungen des Angebots

Beispiel

{
  "googleBusinessConfigs": [{
    "connectionId": "conn_gbp_001",
    "topicType": "EVENT",
    "eventTitle": "Live music night",
    "eventStart": "2026-10-16T19:00",
    "eventEnd": "2026-10-16T23:00",
    "callToActionType": "LEARN_MORE",
    "callToActionUrl": "https://example.com/events/live-music"
  }]
}

Tumblr

Parameter	Typ	Beschreibung
`connectionId`ERFORDERLICH	`string`	Die Konto-id aus /social-accounts, für die diese Konfiguration gilt
`tags`	`string[]`	Bis zu 30 Tags mit je bis zu 140 Zeichen und ohne Kommas. Ein führendes # wird entfernt
`title`	`string`	Überschrift über dem Beitrag, bis zu 4.096 Zeichen
`sourceUrl`	`string`	http- oder https-Link, der als Quelle genannt wird, bis zu 2.048 Zeichen

Beispiel

{
  "tumblrConfigs": [{
    "connectionId": "conn_tumblr_001",
    "title": "Studio notes, week 12",
    "tags": ["art process", "sketchbook"],
    "sourceUrl": "https://example.com/blog/studio-notes"
  }]
}