
Integrationsleitfäden
LinkedIn-API-Leitfaden
E-Mail-API-Leitfaden
WhatsApp-API-Leitfaden
Vertrieb kontaktieren
Facebook-Beiträge 2026 per API veröffentlichen, bearbeiten, löschen und lesen, über Metas Pages API oder die eigenen verbundenen Konten Ihrer Nutzer.
posts
PATCHposts/{id}
DELETEposts/{id}
200 OK
Mit einer Facebook Post API kann Ihre App Facebook-Beiträge per HTTP-Anfrage veröffentlichen, bearbeiten, löschen und lesen. Es gibt zwei Wege: Metas Pages API, die über eine Meta-App und Page Access Tokens nur auf Facebook-Seiten veröffentlicht, oder ein verbundenes Konto, bei dem jeder Nutzer sein eigenes Facebook-Konto verknüpft und Ihre App als sein Profil oder als eine von ihm verwaltete Seite postet.
Für das Gesamtbild der Meta-Plattform lesen Sie, wie die Facebook-APIs zusammenspielen.
Einen Facebook-Beitrag in drei Schritten veröffentlichen
Konto verbindenIhr Nutzer verbindet über Hosted Auth sein Facebook-Konto und die Seiten, die er verwaltet. Keine Meta-App, kein App Review.
Beitrag erstellenSenden Sie POST /v2/{account_id}/posts mit Ihrem Schlüssel in X-API-KEY und einem Text oder Anhängen.
Bearbeiten, löschen oder als Seite postenRufen Sie PATCH oder DELETE auf den Beitrag auf oder ergänzen Sie post_as mit der ID einer aktivierten Seite.
Ein Produkt namens „Post API“ gibt es bei Meta nicht. Facebook-Beiträge sind Objekte der Graph API, und Apps veröffentlichen sie über die Pages API, die nur auf Facebook-Seiten schreibt. Seit 2018 kann eine Drittanbieter-App nicht mehr im eigenen Profil einer Person veröffentlichen.
In der Praxis meint „Facebook Post API“, von Entwicklern auch Facebook API für Beiträge genannt, Aufrufe der Graph API auf einen Post-Knoten und auf die Kante /feed einer Seite. Knoten, Kanten und Tokens: siehe unseren Überblick zur Facebook Graph API.
{page_id}_{post_id}Der Post-Knoten. Seine ID verbindet die Autoren-ID und die Beitrags-ID./{page_id}/feedDie Kante, die die Beiträge einer Seite auflistet und neue entgegennimmt.messageDer Text des Beitrags.created_timeWann der Beitrag veröffentlicht wurde./{page_id}/photosDie Kante für Fotobeiträge.Senden Sie POST /{page_id}/feed mit einer message (und optional einem link) und einem Page Access Token (siehe den Leitfaden zur Facebook Page API und unseren Leitfaden zum Facebook API Zugriffstoken). Meta gibt die ID des neuen Beitrags als {"id": "{page_post_id}"} zurück.
App erstellen und Facebook Login for Business hinzufügen.
pages_show_listVeröffentlichungsrechte anfordern, dann das App Review bestehen.
pages_manage_postsDas Page Token aus dem User Token abrufen.
GET /me/accountsMit dem Page Token im Feed der Seite posten.
POST /{page_id}/feedpages_manage_posts, pages_read_engagement und pages_show_list, von jemandem, der die Aufgabe CREATE_CONTENT auf der Seite ausführen darf.pages_manage_engagement und pages_read_user_engagement, mit den Aufgaben CREATE_CONTENT, MANAGE und MODERATE.publish_video.Anfrage und Antwort finden Sie in den Tabs Meta cURL und Meta Python des Codeblocks weiter unten, neben der Unipile-Version.
| Parameter | Funktion |
|---|---|
message | Der Text des Beitrags |
link | Eine URL, angezeigt mit Linkvorschau |
published | false für einen unveröffentlichten oder geplanten Beitrag |
scheduled_publish_time | Veröffentlichungsdatum, 10 Minuten bis 30 Tage im Voraus |
false für einen unveröffentlichten oder geplanten BeitragFotos und Videos. Ein einzelnes Foto geht an /{page_id}/photos. Für einen Beitrag mit mehreren Fotos laden Sie jedes Foto mit published=false an diese Kante hoch und veröffentlichen sie dann gemeinsam auf /{page_id}/feed mit attached_media und den zurückgegebenen IDs; unveröffentlichte Fotos werden nach 24 Stunden gelöscht. Videos laufen über die Video API mit publish_video.
Quelle: Metas Dokumentation zu Beiträgen in der Pages API, Einstieg in die Pages API, die Referenz zum Seiten-Feed und die Referenz zu Seitenfotos (Graph API v27.0). Zuletzt geprüft: 17. November 2026.
Drei Regeln der Graph API prägen jedes Projekt, das auf Facebook postet: Apps können nicht in privaten Profilen und nicht in Gruppen veröffentlichen und nur die Seitenbeiträge ändern, die sie selbst erstellt haben.
Meta hat Apps die Berechtigung publish_actions am 1. August 2018 entzogen. Details unter Grenzen der offiziellen Facebook-API.
Die Groups API und publish_to_groups wurden mit Graph API v19.0 am 23. Januar 2024 eingestellt.
„Eine App kann einen Seitenbeitrag nur aktualisieren, wenn er mit dieser App erstellt wurde.“
Ihre App kann keinen Beitrag ändern, der auf facebook.com oder mit einem anderen Tool geschrieben wurde. Ein Produkt, das Beiträge bearbeitet, muss sie also selbst erstellen.
Die ersten Fehler, auf die Sie stoßen. In der Graph API bedeutet Code 190, dass der Access Token abgelaufen ist, die Codes 200 bis 299, dass eine Berechtigung nicht erteilt oder entzogen wurde, und 4 oder 17 zu viele Aufrufe. Bei Unipile liefert das Posten als nicht aktivierte Seite 403 api/insufficient_permissions.
Quellen: Metas Dokumentation zu Beiträgen in der Pages API, Facebook Login Changelog, Ankündigung von Graph API v19.0 und Fehlerbehandlung der Graph API. Zuletzt geprüft: 17. November 2026.
Mit Unipile verbindet jeder Nutzer sein Facebook-Konto über Hosted Auth, und Ihre App erhält eine account_id. Sie erstellen einen Beitrag mit POST /v2/{account_id}/posts, ändern seinen Text mit PATCH und entfernen ihn mit DELETE. Ein gelöschter Beitrag landet im Papierkorb, wo sein Autor ihn noch 30 Tage lang lesen kann.
Keine Meta-App und kein App Review auf Ihrer Seite: Jeder Aufruf sendet Ihren API-Schlüssel in X-API-KEY und läuft im Auftrag des Nutzers, der das Konto verbunden hat. Die Meta-Tabs zeigen zum Vergleich dieselbe Veröffentlichung mit der Graph API und einem Page Access Token.
const BASE = "https://api.unipile.com/v2";
const headers = {
"X-API-KEY": process.env.UNIPILE_API_KEY,
"content-type": "application/json"
};
// 1. Publish a text post from the connected account
await fetch(`${BASE}/${ACCOUNT_ID}/posts`, {
method: "POST", headers,
body: JSON.stringify({ text: "Our autumn menu starts Monday." })
});
// 2. Edit its text later (media and audience are kept)
await fetch(`${BASE}/${ACCOUNT_ID}/posts/${POST_ID}`, {
method: "PATCH", headers,
body: JSON.stringify({ text: "Our autumn menu starts Monday at 7am." })
});
import os, requests
BASE = "https://api.unipile.com/v2"
headers = {"X-API-KEY": os.environ["UNIPILE_API_KEY"]}
# 1. Publish a text post from the connected account
requests.post(f"{BASE}/{ACCOUNT_ID}/posts", headers=headers,
json={"text": "Our autumn menu starts Monday."})
# 2. Edit its text later (media and audience are kept)
requests.patch(f"{BASE}/{ACCOUNT_ID}/posts/{POST_ID}", headers=headers,
json={"text": "Our autumn menu starts Monday at 7am."})
# 1. Publish a text post from the connected account
curl --request POST \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/posts" \
--header "X-API-KEY: {YOUR_API_KEY}" \
--header "content-type: application/json" \
--data '{ "text": "Our autumn menu starts Monday." }'
# 2. Edit its text later (media and audience are kept)
curl --request PATCH \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/posts/{POST_ID}" \
--header "X-API-KEY: {YOUR_API_KEY}" \
--header "content-type: application/json" \
--data '{ "text": "Our autumn menu starts Monday at 7am." }'
# Meta Graph API: publish to a Page with a Page access token
curl -X POST "https://graph.facebook.com/v27.0/{PAGE_ID}/feed" \
-H "Content-Type: application/json" \
-d '{
"message": "Our autumn menu starts Monday.",
"link": "https://example.com/menu",
"access_token": "{PAGE_ACCESS_TOKEN}"
}'
# Response: the ID of the new Page post
{ "id": "{PAGE_POST_ID}" }
# Read that post back with the fields you need
curl -G "https://graph.facebook.com/v27.0/{PAGE_POST_ID}" \
-d "fields=id,message,created_time,permalink_url" \
-d "access_token={PAGE_ACCESS_TOKEN}"
import os, requests
GRAPH = "https://graph.facebook.com/v27.0"
TOKEN = os.environ["PAGE_ACCESS_TOKEN"]
# Meta Graph API: publish to a Page
r = requests.post(f"{GRAPH}/{PAGE_ID}/feed", data={
"message": "Our autumn menu starts Monday.",
"link": "https://example.com/menu",
"access_token": TOKEN,
})
post_id = r.json()["id"] # {"id": "{PAGE_POST_ID}"}
# Read that post back with the fields you need
post = requests.get(f"{GRAPH}/{post_id}", params={
"fields": "id,message,created_time,permalink_url",
"access_token": TOKEN,
}).json()
Die Felder der Anfrage stehen unter Create posts, Bearbeiten und Papierkorb unter Edit and delete posts. Die Meta-Tabs folgen dem Leitfaden zu Beiträgen in der Pages API und der Post-Referenz, v27.0, geprüft am 17. Nov. 2026.
| Feld oder Fall | Regel |
|---|---|
text und attachments | Text oder Anhang erforderlich. Dateien in base64 oder als multipart bei großen Dateien |
| Bilder | Mehrere Bilder ergeben ein Album |
| Video | Ein Video pro Beitrag, nie mit Bildern gemischt |
quoted_post_id | Teilt einen Beitrag, ohne Anhänge |
| Erwähnungen | @ plus eine ID oder ein Vanity-Name in text |
can_read | anyone (Standard) oder relations_only |
can_comment | Nur anyone, sonst 400 |
@ plus eine ID oder ein Vanity-Name in textanyone (Standard) oder relations_onlyanyone, sonst 400Ihre Nutzer posten aus ihren eigenen Konten
Unipile ist weder ein Meta-Produkt noch ein Meta-Partner. Ihre Nutzer verbinden ihre eigenen Konten, entscheiden, was veröffentlicht wird, und bleiben an die Bedingungen von Meta gebunden.
Fügen Sie post_as mit der ID einer Seite hinzu, die das Konto administriert und die auf dem Konto aktiviert ist. Ein separates Konto müssen Sie nicht verbinden: Dieselbe account_id umfasst das Profil des Nutzers und seine Seiten.
PAGE_<page_id>_INBOX.403 api/insufficient_permissions.Die Einrichtungsschritte stehen in der Dokumentation zu Facebook-Seiten.
POST /v2/{account_id}/posts
{
"text": "Hello from our Page!",
"post_as": "1357020157484056"
}
Mit Metas API rufen Sie GET /{page_id}/feed mit einem Page Access Token auf. Mit Unipile rufen Sie GET /v2/ auf, wobei user_id entweder me, die ID einer aktivierten Seite oder die ID einer anderen Person oder Seite ist, deren Beiträge das verbundene Konto auf Facebook bereits sehen kann.
Typische Nutzung: die letzten Aktivitäten in einem CRM oder Social-Media-Tool, für Konten, die Ihre Nutzer verbunden haben. Das Lesen fremder Beiträge bleibt auf das beschränkt, was das verbundene Konto auf Facebook bereits sieht, und geschieht, wenn der Nutzer es anfordert.
Ich freue mich, nächsten Monat zum Team in Lissabon zu stoßen!
Die Folien meines Vortrags zu Support-Tools sind online.
Wochenendwanderung mit dem Team.
next_cursor: "QVFIUm..."v2/{ACCOUNT_ID}/users/{USER_ID}/posts
200 OK
/v2/{account_id}/users/{user_id}/posts me, die ID einer aktivierten Seite oder die ID einer anderen Person oder Seite, beschränkt auf Beiträge, die das verbundene Konto bereits sehen kann/v2/{account_id}/posts/{post_id} <author id>_<post id>account_idFacebook liefert bis zu 3 Beiträge pro Seite, unabhängig vom gesendeten limit. Folgen Sie next_cursor, um die nächste Seite zu erhalten; ein offset gibt es nicht. Details unter List user posts.
Metas Pages API passt zu einer App, die auf den eigenen Unternehmensseiten veröffentlicht oder auf Kundenseiten, die über Ihre Meta-App laufen. Ein verbundenes Konto passt zu einem SaaS-Produkt, in dem jeder Nutzer aus seinem eigenen Profil und seinen Seiten veröffentlicht, ohne Meta-App auf Ihrer Seite.
| Kriterium | Meta Pages API | Verbundenes Konto (Unipile) |
|---|---|---|
| Abgedeckte Konten | Seiten, die die Nutzer Ihrer App verwalten | Das Profil des Nutzers und die Seiten, die er verwaltet |
| Einrichtung auf Ihrer Seite | Meta-App, Facebook Login, App Review | API-Schlüssel und Hosted Auth, kein App Review |
| Zugangsdaten | Ein Page Token pro Seite | Eine account_id pro Nutzer |
| Beiträge im privaten Profil | Seit 2018 nicht verfügbar | Ja, als verbundener Nutzer |
| Beiträge bearbeiten | Nur mit Ihrer App erstellte Beiträge | Text eines Beitrags, per post_id |
| Gruppen | In v19.0 eingestellt | Nicht unterstützt |
| Stories | Nicht Teil dieses Leitfadens | Nicht unterstützt |
| Planung | scheduled_publish_time, 10 Minuten bis 30 Tage | Nicht dokumentiert, nutzen Sie Ihre eigene Job-Queue |
| Andere Netzwerke | Nur Facebook-Seiten | Dieselbe API für LinkedIn, Instagram, WhatsApp und mehr |
account_id pro Nutzerpost_idscheduled_publish_time, 10 Minuten bis 30 TageDieselbe Verbindung umfasst auch Unterhaltungen: siehe die Facebook- und Messenger-API von Unipile, wie Sie ein privates Facebook-Konto verbinden, und die Preise der Facebook Messenger API.
Die Facebook Post API lohnt sich in Produkten, in denen die Menschen ohnehin arbeiten, wobei jeder Nutzer aus seinen eigenen Konten veröffentlicht.
Community Manager veröffentlichen und korrigieren Beiträge für ihr Profil und ihre Seiten, direkt neben ihren Nachrichten.
Auf Anfrage des Vertriebsmitarbeiters zeigt ein Kontaktdatensatz die neuesten Beiträge der Person, beschränkt auf das, was sein verbundenes Konto auf Facebook ohnehin sieht.
Ein Agent entwirft einen Beitrag, der Nutzer gibt ihn frei, und erst dann sendet Ihre App den POST.
Dasselbe Beitragsmodell funktioniert auch für andere Netzwerke: Unsere Anleitung zur Instagram-API behandelt das andere Meta-Netzwerk.
Veröffentlichen Sie Facebook-Beiträge aus Ihrer App
Nutzen Sie Metas Pages API für Ihre eigenen Seiten. Wenn jeder Nutzer Beiträge aus seinem eigenen Profil und seinen Seiten veröffentlicht, bearbeitet und liest, verbinden Sie seine Konten über Unipile: eine einzige REST API.
Jeder Nutzer verbindet sein eigenes Konto, ohne Speicherung von Profilen. Unipile ist kein Meta-Partner. Mehr erfahren
Alle Endpoints der Facebook-API an einem Ort
Beiträge sind nur ein Teil des Ganzen. Sehen Sie alle mit Unipile verfügbaren Facebook-Endpoints, von Nachrichten bis zu Profilen, oder lesen Sie den vollständigen Leitfaden zur Facebook-API.
Kurze Antworten zu Seiten, Fotos, Planung, Änderungen, Gruppen, Videos und dem Lesen von Beiträgen.
Mit Metas Pages API senden Sie POST /{page_id}/feed mit einer message, einem Page Access Token und den Berechtigungen pages_manage_posts, pages_read_engagement und pages_show_list. Mit Unipile verbindet der Nutzer sein Facebook-Konto einmalig, und Sie rufen POST /v2/{account_id}/posts auf, wobei post_as die ID einer Seite enthält, die er verwaltet und aktiviert hat.
Mit Unipile werden mehrere Bilder in einem Beitrag als Album angezeigt, und ein Beitrag kann stattdessen ein Video enthalten, nie beides. Mit Metas Pages API werden Fotos über die Kante /{page_id}/photos veröffentlicht.
Metas Pages API kann das: Erstellen Sie den Beitrag mit published auf false und einer scheduled_publish_time zwischen 10 Minuten und 30 Tagen im Voraus, laut Leitfaden zur Pages API (die Referenz zum Page Feed nennt 75 Tage; testen Sie es mit Ihrer Version). Unipile dokumentiert keine native Planung. Speichern Sie das geplante Datum daher in Ihrer eigenen Job-Queue und rufen Sie POST /v2/{account_id}/posts zum Fälligkeitszeitpunkt auf.
Ja. Mit Metas API kann eine App nur die Seitenbeiträge aktualisieren, die sie selbst erstellt hat, und löscht einen Beitrag mit DELETE /{page_post_id}. Mit Unipile ändert PATCH /v2/{account_id}/posts/{post_id} den Text, und DELETE verschiebt den Beitrag in den Papierkorb, wo sein Autor ihn noch 30 Tage lang lesen kann.
Nein. Meta hat die Groups API und die Berechtigung publish_to_groups mit Graph API v19.0 im Januar 2024 eingestellt, und auch Unipile unterstützt keine Veröffentlichung in Gruppen.
Ein Video können Sie posten. Mit Unipile enthält ein Beitrag ein Video, das Facebook asynchron verarbeitet. Reels sind nicht dokumentiert, und Stories werden nicht unterstützt.
Mit Metas Graph API rufen Sie GET /{page_id}/feed mit einem Page Access Token und den Berechtigungen pages_read_engagement und pages_read_user_content auf; limit liefert höchstens 100 Beiträge pro Anfrage. Mit Unipile rufen Sie GET /v2/{account_id}/users/{user_id}/posts mit der ID einer aktivierten Seite auf und folgen dann next_cursor, um die nächste Seite zu erhalten.
Nein. Unipile ist ein unabhängiges Unternehmen, kein Meta Partner, und wird von Meta weder unterstützt noch gesponsert oder genehmigt. Die Beiträge, die Ihre App veröffentlicht, stammen aus den eigenen Facebook-Konten und Seiten Ihrer Nutzer. Facebook ist eine Marke von Meta Platforms, Inc.
Nein. Um Beiträge über Unipile zu veröffentlichen oder zu lesen, verbinden Ihre Nutzer ihr eigenes Facebook-Konto und die Seiten, die sie verwalten, über die gehostete Authentifizierung. Sie sparen sich die Meta-App, die Berechtigungen zum Posten und das App Review, die der Weg über die Pages API erfordert.
Unipile ist im Sinne des Digital Markets Act konzipiert: Jeder Nutzer verbindet sein eigenes Konto und entscheidet, was gepostet wird, und Unipile handelt in seinem Namen, ohne Nutzerprofile zu speichern. Mehr dazu auf unserer Seite zum Digital Markets Act.
Ja. Jeder Beitrag, den Ihre App veröffentlicht oder liest, läuft über ein Konto, das an die Nutzungsbedingungen von Meta gebunden bleibt. Bleiben Sie bei legitimen Nutzungen, etwa dem Veröffentlichen eigener Inhalte Ihrer Nutzer und dem Anzeigen von Beiträgen, die ihr Konto bereits sieht, wenn sie danach fragen; Spam und unerlaubte Automatisierung können zur Einschränkung von Konten führen.
Noch Fragen? Unser Team hilft Ihnen gern.
Mit einem Experten sprechen