DE
Leitfaden zu Access Tokens

Facebook API Access Token: User, Page, App und System User Tokens erklärt

Wie Sie jedes Token erhalten, es auf etwa 60 Tage verlängern, mit debug_token prüfen und Fehler 190 behandeln, und wie eine SaaS-App die Token-Pipeline ganz umgeht.

Token-Prüfung 200 OK
GETgraph.facebook.com/debug_token?input_token={USER_ACCESS_TOKEN}
applicationIhre App
is_validtrue
expires_atin 60 Tagenlanglebiges User Token
data_access_expires_atin 90 Tagenverlängert, solange der Nutzer aktiv ist
scopespublic_profilepages_show_list
TOKEN Kein Refresh Token: erneut prüfen, dann neu anmelden
Kurz gesagt

Ein Facebook API Access Token ist die Zeichenkette, die jeder Aufruf der Graph API benötigt. Ein User Token erhalten Sie über Facebook Login (oder für Tests über den Graph API Explorer). Auf Ihrem Server tauschen Sie es gegen ein langlebiges Token mit etwa 60 Tagen Laufzeit und rufen dann /me/accounts für die Page Tokens auf. Es gibt keinen API-Schlüssel und kein Refresh Token: Überwachen Sie Tokens mit debug_token und behandeln Sie Fehler 190.

Für ein SaaS mit vielen Kunden gibt es ein zweites Modell: Ihre Nutzer verbinden ihre Facebook-Konten über Unipile, und Ihre App verwaltet nie ein Meta-Token.

Mit Unipile

Kein Meta-Token zu beschaffen, zu verlängern oder zu debuggen

  1. 1

    Konto verbinden

    Ihr Nutzer verbindet sein Facebook-Konto oder seine Seite einmalig über Hosted Auth. Keine Meta-App, kein App Review.

  2. 2

    Mit Ihrem API-Schlüssel aufrufen

    Senden Sie X-API-KEY mit der account_id des Nutzers: GET /v2/{ACCOUNT_ID}/chats.

  3. 3

    Einen einzigen Status überwachen

    Prüfen Sie products_connection_status; bei Bedarf verbindet sich der Nutzer erneut über Hosted Auth.

Definition

Was ist ein Facebook API Access Token?

Meta definiert ein Access Token als „eine undurchsichtige Zeichenkette, die einen Nutzer, eine App oder eine Facebook-Seite identifiziert“. Jede Anfrage an die Graph API enthält eines, und sein Typ bestimmt, in wessen Namen Sie handeln.

TokenHandelt fürSo erhalten Sie esLaufzeit und Einsatz
UserEine angemeldete PersonFacebook Login oder Graph API Explorer1 bis 2 Stunden oder etwa 60 Tage
PageEine Facebook-Seite/me/accounts mit dem User Token eines AdminsFolgt seinem User Token
AppIhre Meta-AppAufruf mit client_credentials oder {APP_ID}|{APP_SECRET}Nur für Server-zu-Server-Aufrufe
System UserIhr UnternehmenBusiness SettingsKein Ablauf oder 60 Tage
ClientIhre App, im Client-CodeApp DashboardNicht geheim
User Token
Handelt fürEine angemeldete Person
So erhalten Sie esFacebook Login oder Graph API Explorer
Laufzeit und Einsatz1 bis 2 Stunden oder etwa 60 Tage
Page Token
Handelt fürEine Facebook-Seite
So erhalten Sie es/me/accounts mit dem User Token eines Admins
Laufzeit und EinsatzFolgt seinem User Token
App Token
Handelt fürIhre Meta-App
So erhalten Sie esAufruf mit client_credentials oder {APP_ID}|{APP_SECRET}
Laufzeit und EinsatzNur für Server-zu-Server-Aufrufe
System User Token
Handelt fürIhr Unternehmen
So erhalten Sie esBusiness Settings
Laufzeit und EinsatzKein Ablauf oder 60 Tage
Client Token
Handelt fürIhre App, im Client-Code
So erhalten Sie esApp Dashboard
Laufzeit und EinsatzNicht geheim

Instagram hat einen eigenen Ablauf: siehe unser Instagram API Token.

Quelle: Metas Leitfaden Access Tokens. Zuletzt geprüft: 17. November 2026.

Token erhalten

So erhalten Sie ein Facebook API Access Token

Es gibt keinen Facebook-API-Schlüssel: Jeder Aufruf verwendet ein Access Token. Für Tests erzeugen Sie im Graph API Explorer eines für Ihr eigenes Konto. In der Produktion melden sich Nutzer mit Facebook Login bei Ihrer Meta-App an (for Business, wenn Sie ihre Seiten benötigen), und Ihr Server tauscht den zurückgegebenen Code gegen ein User Access Token.

Test, in 4 Schritten

Graph API Explorer

  1. Öffnen Sie developers.facebook.com/tools/explorer
  2. Wählen Sie Ihre Meta-App und „User Token“
  3. Fügen Sie die benötigten Berechtigungen hinzu
  4. Klicken Sie auf Generate Access Token und bestätigen Sie
Produktion, in 4 Schritten

Facebook Login in Ihrer Meta-App

  1. Erstellen Sie eine Meta-App (App ID, App Secret)
  2. Leiten Sie Nutzer an /dialog/oauth mit client_id, redirect_uri, state weiter
  3. Die Nutzer erteilen Berechtigungen; Sie erhalten einen code
  4. Ihr Server ruft /oauth/access_token mit dem code und dem App Secret auf

Die Antwort enthält access_token, token_type und expires_in. Andere Personen können erst Berechtigungen erteilen, wenn Ihre App über das App Review Advanced Access erhalten hat. Der vollständige Zugangsweg steht in unserem Überblick zur Facebook-API, alles zu Seiten in unserem Leitfaden zur Facebook Page API.

Quelle: Metas Leitfaden Manually Build a Login Flow (Graph API v27.0). Zuletzt geprüft: 17. November 2026.

Langlebiges Token

So erhalten Sie ein langlebiges Access Token

Senden Sie das kurzlebige User Token an GET /oauth/access_token, mit grant_type=fb_exchange_token, Ihrer App ID und Ihrem App Secret. Die Antwort enthält ein langlebiges Token und dessen expires_in, etwa 60 Tage. Meta ist hier eindeutig: „Führen Sie diesen Aufruf von Ihrem Server aus, nicht von einem Client.“

  • Vor dem Ablauf tauschen. „Mit einem abgelaufenen Token können Sie kein langlebiges Token anfordern“: Ist das kurzlebige Token abgelaufen, muss sich der Nutzer erneut anmelden.
  • Speichern Sie das Ablaufdatum als Datum neben dem Token.
  • Nur zum Testen? Der Access Token Debugger hat eine Schaltfläche Extend Access Token, die dasselbe für ein eigenes Token erledigt.

Der Token-Lebenszyklus im Code

Die Tabs 1 bis 3 nutzen die Graph API von Meta; Tab 4 ist Unipile, ohne Meta-Token.

# Server side only: this call carries your App Secret
curl -G "https://graph.facebook.com/oauth/access_token" \
  -d "grant_type=fb_exchange_token" \
  -d "client_id={APP_ID}" \
  -d "client_secret={APP_SECRET}" \
  -d "fb_exchange_token={USER_ACCESS_TOKEN}"

# Response (abridged)
{ "access_token": "{LONG_LIVED_USER_TOKEN}", "expires_in": 5183944 }
# App access token, for server-to-server calls such as debug_token
curl -G "https://graph.facebook.com/oauth/access_token" \
  -d "client_id={APP_ID}" \
  -d "client_secret={APP_SECRET}" \
  -d "grant_type=client_credentials"

# Or pass it directly, without the call
access_token={APP_ID}|{APP_SECRET}
# Check any token with your app token
curl -G "https://graph.facebook.com/debug_token" \
  -d "input_token={LONG_LIVED_USER_TOKEN}" \
  -d "access_token={APP_ID}|{APP_SECRET}"

# Response (abridged)
{ "data": {
    "app_id": "{APP_ID}",
    "is_valid": true,
    "expires_at": 1800057600,
    "data_access_expires_at": 1802649600,
    "scopes": ["public_profile", "pages_show_list"]
} }
# No Meta token: your API key and the user's account_id
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/inboxes" \
  --header "X-API-KEY: {API_KEY}"

# List the chats of the connected account
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats" \
  --header "X-API-KEY: {API_KEY}"
200 OK · langlebiges User Token, etwa 60 Tage
200 OK · nie im Client-Code oder in App-Binärdateien
200 OK · is_valid, expires_at, data_access_expires_at
200 OK · eine account_id, kein Token zu tauschen

Anfragen aus Metas Leitfäden Long-Lived Access Tokens und Access Tokens. Unipile: Dokumentation zu Facebook-Seiten.

Page Tokens in Kürze

Mit dem langlebigen User Token eines Seiten-Admins liefert GET /me/accounts jede Seite mit ihrem eigenen Token, das „kein Ablaufdatum hat und nur unter bestimmten Bedingungen abläuft oder ungültig wird“. Details in unserem Leitfaden zur Facebook Page API; zum Posten damit lesen Sie, wie Sie mit dem Page Token auf einer Seite veröffentlichen.

Gültigkeit

Wie lange ist ein Facebook Access Token gültig?

Laut Meta ist ein kurzlebiges User Token etwa ein bis zwei Stunden gültig, ein langlebiges etwa 60 Tage. Page Tokens aus einem langlebigen Token und manche System User Tokens haben kein Ablaufdatum. Unabhängig davon endet Ihr Zugriff auf die Daten eines Nutzers nach 90 Tagen Inaktivität.

Facebook Token-Laufzeiten laut Meta
Kurzlebiges User Token1 bis 2 Stunden
Langlebiges User TokenEtwa 60 Tage
Page Token aus einem langlebigen User TokenKein Ablaufdatum
System User TokenNie oder 60 Tage
Zugriff auf die Nutzerdaten90 Tage nach der letzten Aktivität
Token-Ablauf ist nicht gleich Ablauf des Datenzugriffs

Meta schreibt: „Der Ablaufzeitraum für den Datenzugriff beträgt 90 Tage, gerechnet ab der letzten Aktivität des Nutzers.“ Der Nutzer bleibt angemeldet, aber Ihre App kann seine Daten erst wieder lesen, wenn er sie erneut autorisiert.

Kein Token ist dauerhaft: Auch ein „nie ablaufendes“ Token wird ungültig, wenn der Nutzer Ihre App entfernt, sein Passwort ändert oder seine Rolle verliert. Meta warnt: „Verlassen Sie sich nicht darauf, dass diese Gültigkeitsdauern gleich bleiben.“

Quellen: Metas Access Tokens, Long-Lived Access Tokens, Authorization vs. data access und System User Tokens. Zuletzt geprüft: 17. November 2026.

System User

System User Access Tokens für Server-zu-Server-Jobs

Ein System User Access Token gehört zu einem System User Ihres Business Managers, nicht zu einer Person. Laut Meta erlaubt es „Ihrer App, programmatische, automatisierte Aktionen an Werbeobjekten oder Seiten auszuführen“. Sie erzeugen es in den Business Settings.

Option 1

Läuft nie ab

Keine Erneuerung, für Fälle, in denen ein geleaktes Token ein vertretbares Risiko ist.

Option 2, empfohlen

Läuft nach 60 Tagen ab

Setzen Sie set_token_expires_in_60_days=true und erneuern Sie es vor Tag 60 mit fb_exchange_token.

  • Nur im selben Unternehmen. System User und App gehören zum selben Business Manager, und „fehlt dem Nutzer der Zugriff, wird die Anfrage abgelehnt“.
  • Zuerst Zugriff auf die Marketing API: Standard Access oder höher.

Quellen: Metas Install apps and generate tokens und Access Tokens. Zuletzt geprüft: 17. November 2026.

Debugging

Facebook Access Token mit debug_token prüfen

Rufen Sie GET /debug_token?input_token={TOKEN} mit einem App Access Token auf (oder mit dem User Token eines Entwicklers der App). Sie erhalten Gültigkeit, Ablauf, Ablauf des Datenzugriffs und die erteilten Berechtigungen. Ohne Code fügen Sie das Token in den Access Token Debugger ein (developers.facebook.com/tools/debug/accesstoken).

Facebook Was debug_token zurückgibt
is_validOb das Token noch funktioniert.
expires_atAblauf des Tokens als Unix-Zeitstempel; 0 bedeutet kein Ablaufdatum.
data_access_expires_atWann der Datenzugriff endet, auch bei gültigem Token.
scopesErteilte Berechtigungen; granular_scopes ergänzt die Ziel-IDs.
app_id, user_idFür wen das Token ausgestellt wurde.
profile_idDie Seiten-ID, bei einem Page Token.

Um in der Produktion zu prüfen, ob ein Facebook Access Token gültig ist, führen Sie die Anfrage aus Tab 3 des Codeblocks oben regelmäßig auf Ihrem Server aus und speichern beide Daten zu jedem Token. Eine fehlende Berechtigung in scopes erklärt die meisten Fehler nach dem Muster „bei mir geht es, bei ihnen nicht“.

Quelle: Metas Referenz zu debug_token (Graph API v27.0). Zuletzt geprüft: 17. November 2026.

Fehler

Fehler beim Facebook Access Token: Code 190 und seine Subcodes

Fehler 190 bedeutet, dass das Facebook Access Token abgelaufen oder ungültig ist. Er kommt als OAuthException zurück, und sein error_subcode zeigt Ihnen, worum Sie den Nutzer bitten müssen. Ein erneuter Versuch mit demselben Token behebt ihn nie.

Facebook Was die Graph API zurückgibt

{ "error": { "type": "OAuthException", "code": 190, "error_subcode": 460, "fbtrace_id": "EJplcsCHuLu" } }

190 error_subcode lesen, fbtrace_id für den Meta-Support aufbewahren
SubcodeBedeutungWas zu tun ist
458App nicht installiertNutzer erneut anmelden
459Nutzer im CheckpointNutzer meldet sich auf facebook.com an
460Passwort geändertNutzer erneut anmelden
463Token abgelaufenAnmelden, dann erneut tauschen
464Nicht bestätigter NutzerNutzer meldet sich auf facebook.com an
467Ungültiges TokenNutzer neu verbinden
492Keine passende Rolle auf der SeiteNeues Token von einem aktuellen Admin
Subcode 458
BedeutungApp nicht installiert
Was zu tun istNutzer erneut anmelden
Subcode 459
BedeutungNutzer im Checkpoint
Was zu tun istNutzer meldet sich auf facebook.com an
Subcode 460
BedeutungPasswort geändert
Was zu tun istNutzer erneut anmelden
Subcode 463
BedeutungToken abgelaufen
Was zu tun istAnmelden, dann erneut tauschen
Subcode 464
BedeutungNicht bestätigter Nutzer
Was zu tun istNutzer meldet sich auf facebook.com an
Subcode 467
BedeutungUngültiges Token
Was zu tun istNutzer neu verbinden
Subcode 492
BedeutungKeine passende Rolle auf der Seite
Was zu tun istNeues Token von einem aktuellen Admin

In einem SaaS mit vielen Kunden ist 492 der Klassiker: Der Admin, der eine Seite verbunden hat, verlässt das Unternehmen. Weitere Codes finden Sie in unserer Tabelle der Facebook-API-Fehler.

Quelle: Metas Leitfaden Graph API error handling. Zuletzt geprüft: 17. November 2026.

Sicherheit

Facebook Access Tokens speichern und absichern

Behandeln Sie jedes Facebook Access Token wie ein Passwort für das dahinterliegende Konto: App Secret und App Tokens bleiben auf Ihrem Server, User und Page Tokens werden im Ruhezustand verschlüsselt, Serveraufrufe mit appsecret_proof signiert und Tokens gelöscht, sobald ein Kunde die Verbindung trennt.

  • Geheimnisse nur serverseitig. Meta: „Codieren Sie App Access Tokens niemals fest in clientseitigen Code oder App-Binärdateien“ und „Verwenden Sie App Access Tokens nur in Server-zu-Server-Aufrufen.“
  • Client Tokens sind öffentlich. Meta weist darauf hin, dass sie „nicht geheim sind“: Autorisieren Sie damit also nie etwas Sensibles.
  • Aufrufe mit appsecret_proof signieren. Meta definiert ihn als „einen sha256-Hash Ihres Access Tokens mit Ihrem App Secret als Schlüssel“; aktivieren Sie Require App Secret im App Dashboard.
  • Im Ruhezustand verschlüsselt, HTTPS bei der Übertragung. Tokens gehören weder in Logs noch in URLs.
  • Ein Datensatz pro Token. Speichern Sie User, Seite, App und expires_at.
  • Beim Trennen löschen. Löschen Sie das Token, wenn ein Nutzer geht.

Quellen: Metas Leitfäden Access Tokens und Securing Requests. Zuletzt geprüft: 17. November 2026.

Mit Unipile

Ohne Token-Verwaltung: Verbinden Sie die Facebook-Konten Ihrer Nutzer

Mit Unipile verbindet jeder Nutzer sein Facebook-Konto einmalig über Hosted Auth. Die Seiten, die er verwaltet, kommen auf derselben account_id an, und Sie rufen die API mit Ihrem eigenen Schlüssel auf (X-API-KEY). Kein Meta-Token, keine Meta-App und kein App Review auf Ihrer Seite.

FrageMeta Access TokensMit Unipile verbundenes Konto
Was Sie speichernEin Token pro Nutzer, dazu eines pro Seite, Admin und AppEine account_id pro Nutzer und ein API-Schlüssel
Was Sie überwachenexpires_at und data_access_expires_at für jedes TokenEin Status pro Seite in metadata.products_connection_status
Was Sie erneuernTausch gegen ein langlebiges Token oder Anmeldung vor Tag 60Kein Meta-Token zu tauschen
Bei Fehler 190Subcode auswerten, dann den Nutzer um erneute Anmeldung bittenDer Nutzer verbindet sich bei Bedarf über Hosted Auth neu
Was Sie speichern
Meta-TokensEin Token pro Nutzer, dazu eines pro Seite, Admin und App
UnipileEine account_id pro Nutzer und ein API-Schlüssel
Was Sie überwachen
Meta-Tokensexpires_at und data_access_expires_at für jedes Token
UnipileEin Status pro Seite in metadata.products_connection_status
Was Sie erneuern
Meta-TokensTausch gegen ein langlebiges Token oder Anmeldung vor Tag 60
UnipileKein Meta-Token zu tauschen
Bei Fehler 190
Meta-TokensSubcode auswerten, dann den Nutzer um erneute Anmeldung bitten
UnipileDer Nutzer verbindet sich bei Bedarf über Hosted Auth neu

Ein verbundenes Konto deckt Nachrichten, Postfächer von Seiten, Beiträge, Kommentare und Reaktionen ab. Eine Seite kann auf ihre Unterhaltungen antworten und Beiträge veröffentlichen, aber keine Unterhaltung beginnen. Siehe Tab 4 oben und unsere Seite zur Facebook Messenger API.

Compliance

Jeder Nutzer verbindet sein eigenes Konto

Unipile ist ein unabhängiges Unternehmen, keine offizielle Meta-App und kein Meta-Partner. Unipile handelt im Auftrag jedes authentifizierten Nutzers, und jeder Nutzer bleibt an die Bedingungen von Meta gebunden.

Mit Facebook entwickeln, ohne Token-Pipeline

Jeder Nutzer verknüpft sein Facebook-Konto einmalig; Sie nutzen eine einzige API für Facebook, LinkedIn, WhatsApp und E-Mail. 7 Tage kostenlos testen.

Europäische Kommission
EU-reguliert Digital Markets Act (DMA)

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

Sobald das Konto verbunden ist, sehen Sie alle mit Unipile verfügbaren Facebook-Endpoints oder lesen Sie den vollständigen Leitfaden zur Facebook-API zu Berechtigungen, Limits und Fehlern.

FAQ zum Facebook API Access Token

Kurze Antworten zu Laufzeit, Erneuerung, Gültigkeitsprüfung und Speicherung von Tokens sowie zu Fehler 190.

Nicht wirklich. Ein langlebiges User Token ist etwa 60 Tage gültig. Daraus abgeleitete Page Tokens und manche System User Tokens haben kein Ablaufdatum, werden aber trotzdem ungültig, wenn der Nutzer Ihre App entfernt, sein Passwort ändert oder seine Rolle verliert. Planen Sie einen Ablauf zum erneuten Verbinden ein.

Nicht im OAuth-Sinne: Meta dokumentiert für Facebook Login keinen refresh_token-Grant. Sie tauschen ein gültiges kurzlebiges Token mit fb_exchange_token; ist ein Token abgelaufen, meldet sich der Nutzer erneut an. In nativen mobilen Apps erneuert Meta langlebige Tokens einmal pro Tag, wenn die Person Ihre App nutzt.

Weil 60 Tage eine Obergrenze sind, kein Versprechen. Ein Token wird vorzeitig ungültig, wenn der Nutzer sein Passwort ändert, Ihre App entfernt, in einen Sicherheits-Checkpoint gerät oder seine Rolle auf der Seite verliert, und Meta warnt, dass sich Gültigkeitsdauern „ohne Vorwarnung ändern oder vorzeitig ablaufen können“. Lesen Sie den error_subcode von Fehler 190, um zu erkennen, welcher Fall vorliegt.

Rufen Sie GET /debug_token?input_token={TOKEN} mit Ihrem App Access Token auf und lesen Sie is_valid, expires_at, data_access_expires_at und scopes aus. Für eine einmalige Prüfung fügen Sie das Token in den Access Token Debugger von Meta ein.

Ja, wenn Sie sie wie Passwörter behandeln: Verschlüsseln Sie sie im Ruhezustand, halten Sie sie aus Logs und Client-Code heraus und verwenden Sie App Secret und App Tokens nur in Server-zu-Server-Aufrufen. Signieren Sie Serveraufrufe mit appsecret_proof.

Fehler 190 mit Subcode 492 bedeutet eine ungültige Sitzung: Der Nutzer hinter einem Page Access Token hat keine passende Rolle mehr auf der Seite. Holen Sie ein neues Page Token von einem aktuellen Admin.

Nein. Unipile ist ein unabhängiges Unternehmen: kein Meta-Partner, keine offizielle Meta-App, und es wird von Meta weder unterstützt noch gesponsert oder genehmigt. Facebook ist eine Marke von Meta Platforms, Inc.

Nein. Sie rufen Unipile mit Ihrem API-Schlüssel und der account_id jedes verbundenen Nutzers auf. Die Nutzer verknüpfen ihr Facebook-Konto und die Seiten, die sie verwalten, über die gehostete Authentifizierung von Unipile: keine Meta-App, kein App Secret und kein App Review auf Ihrer Seite.

Sie ist im Einklang mit dem Digital Markets Act konzipiert: Jeder Nutzer verbindet sein eigenes Konto, und Unipile handelt in seinem Namen, ohne Nutzerprofile zu speichern. Mehr dazu auf unserer Seite zum Digital Markets Act.

Ja. Jedes verbundene Konto bleibt an die Nutzungsbedingungen von Meta gebunden. Nutzen Sie die API für legitime Szenarien wie Kundensupport, CRM und direkte Unterhaltungen; Spam und unerlaubte Automatisierung können zur Einschränkung von Konten führen.

Noch Fragen? Unser Team hilft Ihnen gern.

Mit einem Experten sprechen