v1Ressourcen/Posts/patchBeitrag aktualisieren
Beitrag aktualisieren
Teilaktualisierung eines bearbeitbaren Beitrags (draft, scheduled, paused, partial, error oder active): Felder, die Sie nicht senden, bleiben unverändert, und gesendete Listen ersetzen die bestehende Liste. Ein Entwurf bleibt ein Entwurf; zum Veröffentlichen senden Sie draft: false oder ein zukünftiges scheduledFor oder rufen POST /api/v1/posts/{id}/publish auf. Das Bearbeiten eines Live-Beitrags aktualisiert ihn auf seinen Plattformen, außer dass ein auf Facebook veröffentlichter Beitrag seine Bilder, sein Karussell oder seine Schaltfläche nicht ändern kann (422); das Ändern des Zeitplans eines Live-Beitrags liefert 409. Gibt den Beitrag wie GET /api/v1/posts/{id} zurück, mit targets.
patch
posts:write/api/v1/posts/{id}Query-Parameter
idstringerforderlich
Der zu aktualisierende Beitrag.
Anfragetext
locationIdstringoptional
Der Standort, an den gepostet werden soll. Geben Sie diesen oder clientId an.
clientIdstringoptional
Der Kunde, für den auf Markenebene gepostet werden soll. Geben Sie diesen oder locationId an.
namestringoptional
Interner Name/Bezeichnung des Beitrags. Erforderlich, nicht leer.
postTypestring (announcement | event | offer)optional
Beitragstyp. event und offer sind Google-exklusiv.
platformsarray of string (google | facebook | instagram | x | linkedin | pinterest | mastodon | bluesky | threads | tiktok | youtube | reddit | medium | substack | vimeo | dailymotion)optional
Zielplattformen. Senden Sie dies oder connectionIds. Jede Plattform veröffentlicht über die Verbindung des Standorts dafür (bzw. des Kunden bei einem markenweiten Beitrag).
connectionIdsarray of stringoptional
Genaue Ziele: die Verbindungs-IDs, an die veröffentlicht wird, aus GET /api/v1/locations/{id}/publish-targets. Verwenden Sie die Verbindung des Standorts selbst oder die markenweite Seite seines Kunden; eine Google-Verbindung auf Kontoebene, eine archivierte oder eine eines anderen Standorts oder Kunden wird mit 422 abgelehnt. Wenn gesendet, geht der Beitrag genau dorthin und platforms wird daraus abgeleitet. Beim Aktualisieren ersetzt die Liste die Ziele des Beitrags.
linkUrlstringoptional
Der Hauptlink des Beitrags, verwendet von jeder Plattform, die einen anzeigt.
linkCtaKeystringoptional
Die Schaltfläche, die mit linkUrl angezeigt wird, z. B. learn_more, book oder shop.
utmobjectoptional
UTM-Parameter (source, medium, campaign, term), die an linkUrl angehängt werden.
sourcestringoptional
mediumstringoptional
campaignstringoptional
termstringoptional
linkOverrideobjectoptional
Link-Einstellungen pro Plattform, nach Plattform geschlüsselt: eine andere url, Schaltfläche, title, description oder utm für diese Plattform.
linkAppendobjectoptional
Ob linkUrl bei X und Mastodon, die kein Linkfeld haben, ans Ende der Bildunterschrift angehängt wird.
xbooleanoptional
mastodonbooleanoptional
ctaUrlFacebookstringoptional
Schaltflächen-URL nur für Facebook, wenn sie von ctaUrl abweichen soll.
xThreadbooleanoptional
Bei X eine Bildunterschrift, die länger als ein Beitrag ist, in einen Thread aufteilen.
scheduleLocalTimestringoptional
Nach lokaler Uhrzeit planen, "YYYY-MM-DDTHH:mm" ohne Zeitzone. Statt scheduledFor für zeitzonenbewusste Planung verwenden.
scheduleZoneModestring (target_local | fixed_zone)optional
Wie scheduleLocalTime gelesen wird: target_local veröffentlicht zu dieser Uhrzeit in der Zeitzone jedes Ziels; fixed_zone verwendet scheduleTimeZone für alle Ziele.
scheduleTimeZonestringoptional
IANA-Zeitzone für die Planung mit fixed_zone, z. B. "America/New_York".
timeZoneModestring (target_local | fixed_zone)optional
Wie scheduleZoneMode.
articleTitlestringoptional
Artikelfelder für Medium und Substack: Titel, Untertitel und HTML-Text.
articleSubtitlestringoptional
Artikelfelder für Medium und Substack: Titel, Untertitel und HTML-Text.
articleBodyHtmlstringoptional
Artikelfelder für Medium und Substack: Titel, Untertitel und HTML-Text.
canonicalUrlstringoptional
Ursprüngliche URL eines anderswo veröffentlichten Artikels, damit die Plattform die Quelle nennt.
videoCoverUrlstringoptional
Videooptionen: eine URL für das Titelbild sowie eine URL für die Untertiteldatei mit deren Sprache.
videoCaptionsUrlstringoptional
Videooptionen: eine URL für das Titelbild sowie eine URL für die Untertiteldatei mit deren Sprache.
videoCaptionsLanguagestringoptional
Videooptionen: eine URL für das Titelbild sowie eine URL für die Untertiteldatei mit deren Sprache.
facebookCaptionstringoptional
Eine Option nur für Facebook: abweichende Bildunterschrift, Schaltflächentyp, erster Kommentar, Veröffentlichungsformat (default, reel, carousel, suppress_link), Karussellkarten oder Zielgruppen-Targeting.
facebookCtaTypestringoptional
Eine Option nur für Facebook: abweichende Bildunterschrift, Schaltflächentyp, erster Kommentar, Veröffentlichungsformat (default, reel, carousel, suppress_link), Karussellkarten oder Zielgruppen-Targeting.
facebookFirstCommentstringoptional
Eine Option nur für Facebook: abweichende Bildunterschrift, Schaltflächentyp, erster Kommentar, Veröffentlichungsformat (default, reel, carousel, suppress_link), Karussellkarten oder Zielgruppen-Targeting.
facebookPublishAsstring (default | reel | carousel | suppress_link)optional
Eine Option nur für Facebook: abweichende Bildunterschrift, Schaltflächentyp, erster Kommentar, Veröffentlichungsformat (default, reel, carousel, suppress_link), Karussellkarten oder Zielgruppen-Targeting.
facebookCarouselCardsarray of objectoptional
Eine Option nur für Facebook: abweichende Bildunterschrift, Schaltflächentyp, erster Kommentar, Veröffentlichungsformat (default, reel, carousel, suppress_link), Karussellkarten oder Zielgruppen-Targeting.
headlinestringoptional
descriptionstringoptional
linkstringoptional
facebookTargetCountrystringoptional
Eine Option nur für Facebook: abweichende Bildunterschrift, Schaltflächentyp, erster Kommentar, Veröffentlichungsformat (default, reel, carousel, suppress_link), Karussellkarten oder Zielgruppen-Targeting.
facebookTargetGenderstringoptional
Eine Option nur für Facebook: abweichende Bildunterschrift, Schaltflächentyp, erster Kommentar, Veröffentlichungsformat (default, reel, carousel, suppress_link), Karussellkarten oder Zielgruppen-Targeting.
facebookTargetAgeMinstringoptional
Eine Option nur für Facebook: abweichende Bildunterschrift, Schaltflächentyp, erster Kommentar, Veröffentlichungsformat (default, reel, carousel, suppress_link), Karussellkarten oder Zielgruppen-Targeting.
facebookTargetAgeMaxstringoptional
Eine Option nur für Facebook: abweichende Bildunterschrift, Schaltflächentyp, erster Kommentar, Veröffentlichungsformat (default, reel, carousel, suppress_link), Karussellkarten oder Zielgruppen-Targeting.
facebookTargetRelationshipstringoptional
Eine Option nur für Facebook: abweichende Bildunterschrift, Schaltflächentyp, erster Kommentar, Veröffentlichungsformat (default, reel, carousel, suppress_link), Karussellkarten oder Zielgruppen-Targeting.
instagramFirstCommentstringoptional
Eine Option nur für Instagram: erster Kommentar oder Alternativtext des Bildes.
instagramAltTextstringoptional
Eine Option nur für Instagram: erster Kommentar oder Alternativtext des Bildes.
xReplySettingsstring (everyone | following | mentioned)optional
Eine Option nur für X: wer antworten darf.
linkedinVisibilitystring (anyone | connections | followers)optional
Eine Option nur für LinkedIn: Sichtbarkeit oder erster Kommentar.
linkedinFirstCommentstringoptional
Eine Option nur für LinkedIn: Sichtbarkeit oder erster Kommentar.
pinterestTitlestringoptional
Eine Option nur für Pinterest: Pin-Titel, Pinnwand, Ziellink oder Alternativtext.
pinterestBoardIdstringoptional
Eine Option nur für Pinterest: Pin-Titel, Pinnwand, Ziellink oder Alternativtext.
pinterestBoardNamestringoptional
Eine Option nur für Pinterest: Pin-Titel, Pinnwand, Ziellink oder Alternativtext.
pinterestLinkstringoptional
Eine Option nur für Pinterest: Pin-Titel, Pinnwand, Ziellink oder Alternativtext.
pinterestAltTextstringoptional
Eine Option nur für Pinterest: Pin-Titel, Pinnwand, Ziellink oder Alternativtext.
tiktokPrivacyLevelstring (PUBLIC_TO_EVERYONE | MUTUAL_FOLLOW_FRIENDS | SELF_ONLY)optional
Eine Option nur für TikTok: Datenschutzstufe, ob Duette, Stitches und Kommentare erlaubt sind, oder Markeninhalte.
tiktokDisableDuetbooleanoptional
Eine Option nur für TikTok: Datenschutzstufe, ob Duette, Stitches und Kommentare erlaubt sind, oder Markeninhalte.
tiktokDisableStitchbooleanoptional
Eine Option nur für TikTok: Datenschutzstufe, ob Duette, Stitches und Kommentare erlaubt sind, oder Markeninhalte.
tiktokDisableCommentbooleanoptional
Eine Option nur für TikTok: Datenschutzstufe, ob Duette, Stitches und Kommentare erlaubt sind, oder Markeninhalte.
tiktokBrandContentbooleanoptional
Eine Option nur für TikTok: Datenschutzstufe, ob Duette, Stitches und Kommentare erlaubt sind, oder Markeninhalte.
mastodonVisibilitystring (public | unlisted | private | direct)optional
Eine Option nur für Mastodon: Sichtbarkeit, Inhaltswarnung oder sensible Medien.
mastodonSpoilerTextstringoptional
Eine Option nur für Mastodon: Sichtbarkeit, Inhaltswarnung oder sensible Medien.
mastodonSensitivebooleanoptional
Eine Option nur für Mastodon: Sichtbarkeit, Inhaltswarnung oder sensible Medien.
blueskyLanguagestringoptional
Eine Option nur für Bluesky: Sprache des Beitrags oder wer antworten darf.
blueskyReplyGatingstring (everyone | mentioned | following | nobody)optional
Eine Option nur für Bluesky: Sprache des Beitrags oder wer antworten darf.
threadsReplyControlstring (everyone | accounts_you_follow | mentioned_only)optional
Eine Option nur für Threads: wer antworten darf.
redditSubredditstringoptional
Eine Option nur für Reddit: Subreddit, Titel, Beitragstyp, Link oder Flair.
redditTitlestringoptional
Eine Option nur für Reddit: Subreddit, Titel, Beitragstyp, Link oder Flair.
redditPostTypestring (text | link | image | video)optional
Eine Option nur für Reddit: Subreddit, Titel, Beitragstyp, Link oder Flair.
redditUrlstringoptional
Eine Option nur für Reddit: Subreddit, Titel, Beitragstyp, Link oder Flair.
redditFlairstringoptional
Eine Option nur für Reddit: Subreddit, Titel, Beitragstyp, Link oder Flair.
mediumTagsstringoptional
Eine Option nur für Medium: Tags oder Veröffentlichungsstatus.
mediumPublishStatusstring (public | unlisted | draft)optional
Eine Option nur für Medium: Tags oder Veröffentlichungsstatus.
substackSendEmailbooleanoptional
Eine Option nur für Substack: ob Abonnenten per E-Mail benachrichtigt werden.
vimeoTitlestringoptional
Eine Option nur für Vimeo: Titel, Beschreibung, Vorschaubild oder Datenschutz.
vimeoDescriptionstringoptional
Eine Option nur für Vimeo: Titel, Beschreibung, Vorschaubild oder Datenschutz.
vimeoThumbnailUrlstringoptional
Eine Option nur für Vimeo: Titel, Beschreibung, Vorschaubild oder Datenschutz.
vimeoPrivacystring (anybody | unlisted)optional
Eine Option nur für Vimeo: Titel, Beschreibung, Vorschaubild oder Datenschutz.
dailymotionTitlestringoptional
Eine Option nur für Dailymotion: Titel, Beschreibung, Vorschaubild, Kategorie, Kennzeichnung für Kinder oder Datenschutz.
dailymotionDescriptionstringoptional
Eine Option nur für Dailymotion: Titel, Beschreibung, Vorschaubild, Kategorie, Kennzeichnung für Kinder oder Datenschutz.
dailymotionThumbnailUrlstringoptional
Eine Option nur für Dailymotion: Titel, Beschreibung, Vorschaubild, Kategorie, Kennzeichnung für Kinder oder Datenschutz.
dailymotionCategorystringoptional
Eine Option nur für Dailymotion: Titel, Beschreibung, Vorschaubild, Kategorie, Kennzeichnung für Kinder oder Datenschutz.
dailymotionIsForKidsbooleanoptional
Eine Option nur für Dailymotion: Titel, Beschreibung, Vorschaubild, Kategorie, Kennzeichnung für Kinder oder Datenschutz.
dailymotionPrivacystring (public | private)optional
Eine Option nur für Dailymotion: Titel, Beschreibung, Vorschaubild, Kategorie, Kennzeichnung für Kinder oder Datenschutz.
messageGooglestringoptional
Text für Google. Erforderlich, wenn google ausgewählt ist, außer bei draft.
messageFacebookstringoptional
Gemeinsame Bildunterschrift für die sozialen Plattformen (Facebook, Instagram, X, LinkedIn und die anderen). Erforderlich, wenn eine davon ausgewählt ist, außer bei einer reinen TikTok- oder YouTube-Auswahl, sofern der Beitrag kein Entwurf ist. Google verwendet sie nicht, sondern messageGoogle.
captionOverridesobjectoptional
Captions that replace the shared caption on one network only, keyed by network: facebook, instagram, linkedin, x, bluesky, mastodon, threads, pinterest (the pin description), tiktok and youtube (the video description). Each is checked against its own network's limit. On update, only the networks you name change; send null or an empty string for one to go back to the shared caption, or null for the whole field to clear them all. Other networks are refused, because they publish the shared caption.
facebookstringoptional
instagramstringoptional
linkedinstringoptional
xstringoptional
blueskystringoptional
mastodonstringoptional
threadsstringoptional
pintereststringoptional
tiktokstringoptional
youtubestringoptional
ctaTypestring (learn_more | sign_up | order_online | book | buy | call_now)optional
Call-to-Action-Typ.
ctaUrlstringoptional
Ziel-URL des Call-to-Action.
mediaUrlsarray of objectoptional
Anzuhängende Medien, ein Eintrag je Plattform-Anhang.
urlstringoptional
platformstringoptional
typestring (image | video)optional
eventTitlestringoptional
Titel des Events oder Angebots. Erforderlich für ein Google-Event/-Angebot, außer bei draft.
eventStartAtstringoptional
Start des Events oder Angebots, als ISO-8601-Zeitstempel. Erforderlich für ein Google-Event/-Angebot, außer bei draft.
eventEndAtstringoptional
Ende des Events oder Angebots, als ISO-8601-Zeitstempel. Muss nach dem Start liegen.
offerTermsstringoptional
Bedingungen des Angebots.
offerCouponCodestringoptional
Gutscheincode des Angebots.
offerRedeemUrlstringoptional
Einlöse-URL des Angebots.
scheduledForstringoptional
Zu diesem zukünftigen ISO-8601-Zeitstempel veröffentlichen, anstatt sofort.
draftbooleanoptional
Ohne Veröffentlichung speichern. Überspringt Pflichtfeld-Prüfungen; strukturelle Prüfungen (Limits, Medienregeln) gelten weiterhin.
Antwort
dataobjectoptional
Es können weitere interne Felder vorhanden sein, die nicht Teil des stabilen Vertrags sind — verlassen Sie sich nur auf die hier dokumentierten Felder.
idstringoptional
Eindeutige Kennung des Beitrags.
namestringoptional
Interner Name/Bezeichnung des Beitrags.
typestringoptional
Beitragstyp (Duplikat von postType, aus Gründen der Abwärtskompatibilität erhalten).
statusstring (draft | scheduled | paused | publishing | active | partial | error | deleted | expired)optional
Lebenszyklusstatus des Beitrags: draft, scheduled, paused, publishing, active, partial (auf einigen Plattformen live, auf anderen fehlgeschlagen), error, deleted oder expired.
targetsarray of objectoptional
Ein Eintrag pro Ziel des Beitrags, mit eigenem Status.
connectionIdstringoptional
Die Verbindung, über die dieses Ziel veröffentlicht.
platformstringoptional
Die Plattform des Ziels.
statusstringoptional
Status dieser Plattform-Übermittlung: pending, publishing, action_required (die Plattform verlangt eine Aktion des Nutzers), active, error, deleted oder expired.
errorobjectoptional
Vorhanden, wenn dieses Ziel fehlgeschlagen ist: Fehlercode und Meldung von Synup.
codestringoptional
messagestringoptional
postTypestring (announcement | event | offer)optional
Beitragstyp: announcement, event oder offer.
clientIdstringoptional
ID des Kunden, zu dem dieser Beitrag gehört.
locationIdstringoptional
ID des Standorts, zu dem dieser Beitrag gehört, oder null bei einem markenweiten Beitrag.
locationNamestringoptional
Anzeigename des Standorts dieses Beitrags, oder null.
clientNamestringoptional
Anzeigename des Kunden dieses Beitrags, oder null.
platformsarray of stringoptional
Die Plattformen, auf die dieser Beitrag abzielt.
messageGooglestringoptional
Für Google verwendeter Text, oder null.
messageFacebookstringoptional
Gemeinsam genutzter Social-Text für alle Nicht-Google-Plattformen, oder null.
ctaTypestringoptional
Call-to-Action-Typ, oder null.
ctaUrlstringoptional
Call-to-Action-URL, oder null.
ctaUrlFacebookstringoptional
Facebook-spezifische Call-to-Action-URL, oder null.
xThreadbooleanoptional
Ob der X-Thread-Modus aktiviert ist (umgeht das 280-Zeichen-Limit).
ctaJsonobjectoptional
Rohe plattformspezifische Call-to-Action- und Targeting-Einstellungen.
mediaUrlsarray of objectoptional
An den Beitrag angehängte Medien, ein Eintrag je Plattform-Anhang.
urlstringoptional
platformstringoptional
typestring (image | video)optional
eventTitlestringoptional
Titel des Events oder Angebots, oder null.
eventStartAtstringoptional
Start des Events oder Angebots, als ISO-8601-Zeitstempel, oder null.
eventEndAtstringoptional
Ende des Events oder Angebots, als ISO-8601-Zeitstempel, oder null.
offerTermsstringoptional
Bedingungen des Angebots, oder null.
offerCouponCodestringoptional
Gutscheincode des Angebots, oder null.
offerRedeemUrlstringoptional
Einlöse-URL des Angebots, oder null.
scheduledForstringoptional
Wann der Beitrag veröffentlicht werden soll, als ISO-8601-Zeitstempel, oder null für sofortige Veröffentlichung.
createdAtstringoptional
Zeitpunkt der Erstellung des Beitrags, als ISO-8601-Zeitstempel.
performancearray of objectoptional
Übermittlungsleistung je Plattform für diesen Beitrag.
submissionIdstringoptional
Eindeutige Kennung der Plattformübermittlung.
connectionIdstringoptional
ID der Verbindung, über die diese Übermittlung gesendet wurde.
sitestringoptional
Die Plattform, auf die diese Übermittlung abzielt.
viewsnumberoptional
Gesamtzahl der Aufrufe, oder null, falls noch nicht verfügbar.
clicksnumberoptional
Gesamtzahl der Klicks, oder null, falls noch nicht verfügbar.
reactionsnumberoptional
Gesamtzahl der Reaktionen.
sharesnumberoptional
Gesamtzahl der Shares.
commentsnumberoptional
Gesamtzahl der Kommentare.
statusstring (pending | publishing | action_required | active | error | deleted | expired)optional
Status dieser Plattform-Übermittlung: pending, publishing, action_required (die Plattform verlangt eine Aktion des Nutzers), active, error, deleted oder expired.
platformPostIdstringoptional
Die eigene ID der Plattform für den veröffentlichten Beitrag, oder null.
postLinkstringoptional
Öffentliche URL des veröffentlichten Beitrags auf dieser Plattform, oder null.
reviewStatestringoptional
Google-Moderationsstatus (processing, live, rejected), oder null für andere Plattformen.
errorMessagestringoptional
Fehlermeldung, falls diese Übermittlung fehlgeschlagen ist, 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.
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.
patch/api/v1/posts/{id}
Ihr API-Schlüssel
id *
Anfragetext
{
"data": {
"id": "cm_post_abc123",
"name": "Fall Special Announcement (updated)",
"type": "announcement",
"status": "scheduled",
"postType": "announcement",
"clientId": "cm_client_1",
"locationId": "cm_loc_1",
"platforms": [
"google",
"facebook"
],
"messageGoogle": "Join us this weekend — now 25% off all services!",
"messageFacebook": "Join us this weekend — now 25% off all services!",
"ctaType": "learn_more",
"ctaUrl": "https://acmedental.example.com/fall-special",
"ctaUrlFacebook": null,
"xThread": false,
"ctaJson": {
"ctaType": "learn_more",
"ctaUrl": "https://acmedental.example.com/fall-special",
"ctaUrlFacebook": null,
"xThread": false
},
"mediaUrls": [
{
"url": "https://cdn.synup.com/uploads/a1/promo.jpg",
"platform": "facebook",
"type": "image"
}
],
"eventTitle": null,
"eventStartAt": null,
"eventEndAt": null,
"offerTerms": null,
"offerCouponCode": null,
"offerRedeemUrl": null,
"scheduledFor": "2026-02-10T15:00:00.000Z",
"createdAt": "2026-01-20T09:12:00.000Z",
"performance": []
}
}