NL
Gids access tokens

Facebook API Access Token: user, Page, app en system user tokens uitgelegd

Hoe u elk token krijgt, het verlengt tot ongeveer 60 dagen, controleert met debug_token en fout 190 afhandelt, en hoe een SaaS-app de hele tokenpijplijn kan overslaan.

Tokencontrole 200 OK
GETgraph.facebook.com/debug_token?input_token={USER_ACCESS_TOKEN}
applicationUw app
is_validtrue
expires_atover 60 dagenlanglevend user token
data_access_expires_atover 90 dagenverlengd zolang de gebruiker actief is
scopespublic_profilepages_show_list
TOKEN Geen refresh token: opnieuw controleren, dan opnieuw inloggen
Kort antwoord

Een Facebook API access token is de tekenreeks die elke aanroep van de Graph API nodig heeft. U krijgt een user token via Facebook Login (of via de Graph API Explorer om te testen), wisselt het op uw server om voor een langlevend token van ongeveer 60 dagen en roept daarna /me/accounts aan voor de Page tokens. Er is geen API-sleutel en geen refresh token: bewaak tokens met debug_token en handel fout 190 af.

Voor een SaaS met veel klanten bestaat er een tweede model: gebruikers koppelen hun Facebook-account via Unipile, en uw app beheert nooit een token van Meta.

Met Unipile

Geen Meta-token om op te halen, te verlengen of te debuggen

  1. 1

    Koppel het account

    Uw gebruiker koppelt zijn Facebook-account of pagina eenmalig via Hosted Auth. Geen Meta-app, geen App Review.

  2. 2

    Roep aan met uw API-sleutel

    Stuur X-API-KEY mee met het account_id van de gebruiker: GET /v2/{ACCOUNT_ID}/chats.

  3. 3

    Bewaak één status

    Controleer products_connection_status; indien nodig koppelt de gebruiker opnieuw via Hosted Auth.

Definitie

Wat is een Facebook API access token?

Meta omschrijft een access token als “een ondoorzichtige tekenreeks die een gebruiker, een app of een Facebook-pagina identificeert”. Elk verzoek aan de Graph API bevat er een, en het type bepaalt namens wie u handelt.

TokenHandelt namensHoe u het krijgtLevensduur en gebruik
UserEen ingelogde persoonFacebook Login of Graph API Explorer1 tot 2 uur, of ongeveer 60 dagen
PageEen Facebook-pagina/me/accounts met het user token van een beheerderVolgt het bijbehorende user token
AppUw Meta-appclient_credentials-aanroep, of {APP_ID}|{APP_SECRET}Alleen server-to-server-aanroepen
System userUw bedrijfBusiness SettingsVerloopt niet, of na 60 dagen
ClientUw app, in clientcodeApp DashboardGeen geheim
User token
Handelt namensEen ingelogde persoon
Hoe u het krijgtFacebook Login of Graph API Explorer
Levensduur en gebruik1 tot 2 uur, of ongeveer 60 dagen
Page token
Handelt namensEen Facebook-pagina
Hoe u het krijgt/me/accounts met het user token van een beheerder
Levensduur en gebruikVolgt het bijbehorende user token
App token
Handelt namensUw Meta-app
Hoe u het krijgtclient_credentials-aanroep, of {APP_ID}|{APP_SECRET}
Levensduur en gebruikAlleen server-to-server-aanroepen
System user token
Handelt namensUw bedrijf
Hoe u het krijgtBusiness Settings
Levensduur en gebruikVerloopt niet, of na 60 dagen
Client token
Handelt namensUw app, in clientcode
Hoe u het krijgtApp Dashboard
Levensduur en gebruikGeen geheim

Instagram heeft een eigen flow: zie onze gids over het Instagram API-token.

Bron: de gids Access Tokens van Meta. Laatst gecontroleerd: 17 november 2026.

Token krijgen

Zo krijgt u een Facebook API access token

Er bestaat geen Facebook API-sleutel: elke aanroep gebruikt een access token. Om te testen genereert u er een voor uw eigen account in de Graph API Explorer. In productie loggen gebruikers in op uw Meta-app met Facebook Login (for Business als u hun pagina's nodig hebt), en uw server wisselt de teruggestuurde code om voor een user access token.

Testen, in 4 stappen

Graph API Explorer

  1. Open developers.facebook.com/tools/explorer
  2. Kies uw Meta-app en “User Token”
  3. Voeg de permissies toe die u nodig hebt
  4. Klik op Generate Access Token en keur goed
Productie, in 4 stappen

Facebook Login in uw Meta-app

  1. Maak een Meta-app (App ID, App Secret)
  2. Stuur gebruikers naar /dialog/oauth met client_id, redirect_uri, state
  3. Ze verlenen permissies; u ontvangt een code
  4. Uw server roept /oauth/access_token aan met de code en het App Secret

Het antwoord bevat access_token, token_type en expires_in. Andere mensen kunnen pas permissies verlenen zodra App Review uw app Advanced Access geeft. Het volledige toegangstraject staat in ons Facebook API-overzicht, en de kant van de pagina's in onze gids over de Facebook Page API.

Bron: de gids Manually Build a Login Flow van Meta (Graph API v27.0). Laatst gecontroleerd: 17 november 2026.

Langlevend token

Zo krijgt u een langlevend access token

Stuur het kortlevende user token naar GET /oauth/access_token met grant_type=fb_exchange_token, uw App ID en uw App Secret. Het antwoord bevat een langlevend token en de bijbehorende expires_in, ongeveer 60 dagen. Meta is duidelijk: “Doe deze aanroep vanaf uw server, niet vanaf een client.”

  • Wissel om vóór het verloopt. “U kunt geen verlopen token gebruiken om een langlevend token aan te vragen”: zodra het korte token verlopen is, moet de gebruiker opnieuw inloggen.
  • Sla de vervaldatum op als datum naast het token.
  • Alleen om te testen? De Access Token Debugger heeft een knop Extend Access Token die hetzelfde doet voor een token van uzelf.

De levenscyclus van een token in code

Tabbladen 1 tot 3 gebruiken de Graph API van Meta; tabblad 4 is Unipile, zonder token van Meta.

# 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 · langlevend user token, ongeveer 60 dagen
200 OK · nooit in clientcode of app-binaries
200 OK · is_valid, expires_at, data_access_expires_at
200 OK · één account_id, geen token om te wisselen

Verzoeken uit de gidsen Long-Lived Access Tokens en Access Tokens van Meta. Unipile: documentatie over Facebook Pages.

Page tokens in het kort

Met het langlevende user token van een paginabeheerder geeft GET /me/accounts elke pagina terug met een eigen token, dat “geen vervaldatum heeft en alleen onder bepaalde voorwaarden verloopt of ongeldig wordt”. Details in onze gids over de Facebook Page API; om ermee te posten, zie hoe u op een pagina publiceert met haar token.

Levensduur

Hoe lang is een Facebook access token geldig?

Volgens Meta gaat een kortlevend user token ongeveer een tot twee uur mee en een langlevend token ongeveer 60 dagen. Page tokens die uit een langlevend token komen en sommige system user tokens hebben geen vervaldatum. Daarnaast stopt uw toegang tot de gegevens van een gebruiker na 90 dagen inactiviteit.

Facebook Levensduur van tokens, volgens Meta
Kortlevend user token1 tot 2 uur
Langlevend user tokenOngeveer 60 dagen
Page token, uit een langlevend user tokenGeen vervaldatum
System user tokenNooit, of na 60 dagen
Toegang tot de gegevens van de gebruiker90 dagen na de laatste activiteit
Het verlopen van het token is niet het verlopen van de gegevenstoegang

Meta stelt dat “de verloopperiode voor gegevenstoegang 90 dagen is, gerekend vanaf de laatste activiteit van de gebruiker.” De gebruiker blijft ingelogd, maar uw app kan zijn gegevens pas weer lezen als hij de app opnieuw autoriseert.

Geen enkel token is permanent: ook een token dat “nooit verloopt” werkt niet meer zodra de gebruiker uw app verwijdert, zijn wachtwoord wijzigt of zijn rol verliest. Meta waarschuwt: “Reken er niet op dat deze levensduur hetzelfde blijft.”

Bronnen: de gidsen van Meta Access Tokens, Long-Lived Access Tokens, Authorization vs. data access en system user tokens. Laatst gecontroleerd: 17 november 2026.

System user

System user access tokens voor server-to-server-taken

Een system user access token hoort bij een system user van uw Business Manager, niet bij een persoon. Volgens Meta laat het “uw app programmatische, geautomatiseerde acties uitvoeren op advertentieobjecten of pagina's”. U genereert het in Business Settings.

Optie 1

Verloopt nooit

Geen vernieuwing, voor gevallen waarin een gelekt token een aanvaardbaar risico is.

Optie 2, aanbevolen

Verloopt na 60 dagen

Stel set_token_expires_in_60_days=true in en vernieuw met fb_exchange_token vóór dag 60.

  • Alleen binnen hetzelfde bedrijf. De system user en de app horen bij dezelfde Business Manager, en “als de gebruiker geen toegang heeft, wordt het verzoek geweigerd.”
  • Eerst toegang tot de Marketing API: standaardtoegang of hoger.

Bronnen: de gidsen Install apps and generate tokens en Access Tokens van Meta. Laatst gecontroleerd: 17 november 2026.

Debug

Zo controleert u een Facebook access token met debug_token

Roep GET /debug_token?input_token={TOKEN} aan met een app access token (of het user token van een developer van de app). U krijgt de geldigheid, de vervaldatum, het einde van de gegevenstoegang en de verleende permissies terug. Zonder code plakt u het token in de Access Token Debugger (developers.facebook.com/tools/debug/accesstoken).

Facebook Wat debug_token teruggeeft
is_validOf het token nog werkt.
expires_atVervaldatum van het token, als Unix-timestamp; 0 betekent geen vervaldatum.
data_access_expires_atWanneer de gegevenstoegang eindigt, ook met een geldig token.
scopesVerleende permissies; granular_scopes voegt de doel-ID's toe.
app_id, user_idVoor wie het token is uitgegeven.
profile_idDe ID van de pagina, voor een Page token.

Om in productie te controleren of een Facebook access token geldig is, voert u het verzoek uit tabblad 3 van het codeblok hierboven periodiek uit op uw server en slaat u beide datums bij elk token op. Een ontbrekende permissie in scopes verklaart de meeste bugs van het type “bij mij werkt het, bij hen niet”.

Bron: de referentie van debug_token van Meta (Graph API v27.0). Laatst gecontroleerd: 17 november 2026.

Fouten

Fouten met het Facebook access token: code 190 en de subcodes

Fout 190 betekent dat het Facebook access token verlopen of ongeldig is. De fout komt terug als OAuthException, en de error_subcode vertelt u wat u de gebruiker moet vragen. Opnieuw proberen met hetzelfde token lost het nooit op.

Facebook Wat de Graph API teruggeeft

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

190 Lees error_subcode, bewaar fbtrace_id voor de support van Meta
SubcodeBetekenisWat te doen
458App niet geïnstalleerdGebruiker opnieuw laten inloggen
459Gebruiker geblokkeerd door een controleGebruiker logt in op facebook.com
460Wachtwoord gewijzigdGebruiker opnieuw laten inloggen
463Token verlopenInloggen, dan opnieuw omwisselen
464Niet-bevestigde gebruikerGebruiker logt in op facebook.com
467Ongeldig tokenGebruiker opnieuw koppelen
492Geen geschikte rol op de paginaNieuw token via een huidige beheerder
Subcode 458
BetekenisApp niet geïnstalleerd
Wat te doenGebruiker opnieuw laten inloggen
Subcode 459
BetekenisGebruiker geblokkeerd door een controle
Wat te doenGebruiker logt in op facebook.com
Subcode 460
BetekenisWachtwoord gewijzigd
Wat te doenGebruiker opnieuw laten inloggen
Subcode 463
BetekenisToken verlopen
Wat te doenInloggen, dan opnieuw omwisselen
Subcode 464
BetekenisNiet-bevestigde gebruiker
Wat te doenGebruiker logt in op facebook.com
Subcode 467
BetekenisOngeldig token
Wat te doenGebruiker opnieuw koppelen
Subcode 492
BetekenisGeen geschikte rol op de pagina
Wat te doenNieuw token via een huidige beheerder

In een SaaS met veel klanten is 492 de klassieker: de beheerder die een pagina heeft gekoppeld, vertrekt. Andere codes staan in onze tabel met fouten van de Facebook API.

Bron: de gids Graph API error handling van Meta. Laatst gecontroleerd: 17 november 2026.

Beveiliging

Facebook access tokens opslaan en beveiligen

Behandel elk Facebook access token als een wachtwoord voor het account erachter: houd het App Secret en app tokens op uw server, versleutel user en Page tokens in rust, onderteken serveraanroepen met appsecret_proof en verwijder tokens zodra een klant ontkoppelt.

  • Geheimen alleen aan de serverkant. Meta: “Zet app access tokens nooit hard in clientcode of app-binaries” en “Gebruik app access tokens alleen in server-to-server-aanroepen.”
  • Client tokens zijn openbaar. Meta merkt op dat ze “niet geheim zijn”, dus gebruik er nooit een om iets gevoeligs te autoriseren.
  • Onderteken aanroepen met appsecret_proof. Meta omschrijft het als “een sha256-hash van uw access token, met uw app secret als sleutel”; schakel Require App Secret in het App Dashboard in.
  • Versleuteld in rust, HTTPS onderweg. Houd tokens uit logs en URL's.
  • Eén record per token. Sla de gebruiker, de pagina, de app en expires_at op.
  • Opschonen bij ontkoppelen. Verwijder het token zodra een gebruiker vertrekt.

Bronnen: de gidsen Access Tokens en Securing Requests van Meta. Laatst gecontroleerd: 17 november 2026.

Met Unipile

Geen tokenbeheer meer: koppel de Facebook-accounts van uw gebruikers

Met Unipile koppelt elke gebruiker zijn Facebook-account één keer, via Hosted Auth. De pagina's die hij beheert komen mee op hetzelfde account_id, en u roept de API aan met uw eigen sleutel (X-API-KEY). Geen token van Meta, geen Meta-app en geen App Review aan uw kant.

VraagAccess tokens van MetaGekoppeld account bij Unipile
Wat u opslaatEén token per gebruiker, plus een per pagina, beheerder en appEen account_id per gebruiker en één API-sleutel
Wat u bewaaktexpires_at en data_access_expires_at voor elk tokenEen status per pagina in metadata.products_connection_status
Wat u vernieuwtOmwisseling naar langlevend of nieuwe login vóór dag 60Geen token van Meta om te wisselen
Bij fout 190Subcode uitlezen en de gebruiker opnieuw laten inloggenDe gebruiker koppelt zo nodig opnieuw via Hosted Auth
Wat u opslaat
Tokens van MetaEén token per gebruiker, plus een per pagina, beheerder en app
UnipileEen account_id per gebruiker en één API-sleutel
Wat u bewaakt
Tokens van Metaexpires_at en data_access_expires_at voor elk token
UnipileEen status per pagina in metadata.products_connection_status
Wat u vernieuwt
Tokens van MetaOmwisseling naar langlevend of nieuwe login vóór dag 60
UnipileGeen token van Meta om te wisselen
Bij fout 190
Tokens van MetaSubcode uitlezen en de gebruiker opnieuw laten inloggen
UnipileDe gebruiker koppelt zo nodig opnieuw via Hosted Auth

Een gekoppeld account dekt berichten, inboxen van pagina's, posts, opmerkingen en reacties. Een pagina kan haar gesprekken beantwoorden en posts publiceren, maar geen gesprek starten. Zie tabblad 4 hierboven en onze pagina over de Facebook Messenger API.

Compliance

Elke gebruiker koppelt zijn eigen account

Unipile is een onafhankelijk bedrijf, geen officiële Meta-app en geen Meta Partner. Unipile handelt namens elke geauthenticeerde gebruiker, en elke gebruiker blijft gebonden aan de voorwaarden van Meta.

Bouw op Facebook zonder tokenpijplijn

Elke gebruiker koppelt zijn Facebook-account één keer; u gebruikt één API voor Facebook, LinkedIn, WhatsApp en e-mail. 7 dagen gratis proberen.

Europese Commissie
EU-gereguleerd Digital Markets Act (DMA)

Elke gebruiker koppelt zijn eigen account, zonder opslag van profielen. Unipile is geen Meta Partner. Meer informatie

Alle endpoints van de Facebook API op één plek

Zodra het account gekoppeld is, bekijkt u elk Facebook-endpoint dat beschikbaar is met Unipile, of leest u de volledige Facebook API-gids voor permissies, limieten en fouten.

FAQ over het Facebook API access token

Snelle antwoorden over de levensduur van tokens, vernieuwen, geldigheidscontrole, opslag en fout 190.

Niet echt. Een langlevend user token gaat ongeveer 60 dagen mee. Page tokens die daarvan zijn afgeleid en sommige system user tokens hebben geen vervaldatum, maar werken toch niet meer zodra de gebruiker uw app verwijdert, zijn wachtwoord wijzigt of zijn rol verliest. Voorzie een flow om opnieuw te koppelen.

Niet in de OAuth-betekenis: Meta documenteert geen refresh_token-grant voor Facebook Login. U wisselt een geldig kortlevend token om met fb_exchange_token; zodra een token verlopen is, logt de gebruiker opnieuw in. In native mobiele apps vernieuwt Meta langlevende tokens één keer per dag wanneer de persoon uw app gebruikt.

Omdat 60 dagen een maximum is, geen belofte. Een token vervalt eerder wanneer de gebruiker zijn wachtwoord wijzigt, uw app verwijdert, op een beveiligingscontrole stuit of zijn rol op de pagina verliest, en Meta waarschuwt dat de levensduur “zonder waarschuwing kan veranderen of eerder kan verlopen”. Lees de error_subcode van fout 190 om te weten welk geval het is.

Roep GET /debug_token?input_token={TOKEN} aan met uw app access token en lees is_valid, expires_at, data_access_expires_at en scopes. Voor een eenmalige controle plakt u het token in de Access Token Debugger van Meta.

Ja, als u ze behandelt als wachtwoorden: versleutel ze in rust, houd ze uit logs en clientcode, en gebruik het App Secret en app tokens alleen in server-to-server-aanroepen. Onderteken serveraanroepen met appsecret_proof.

Fout 190 met subcode 492 betekent een ongeldige sessie: de gebruiker achter een Page access token heeft geen geschikte rol meer op de pagina. Haal een nieuw Page token op via een huidige beheerder.

Nee. Unipile is een onafhankelijk bedrijf: geen Meta Partner, geen officiële Meta-app, en Meta onderschrijft, sponsort of keurt het niet goed. Facebook is een handelsmerk van Meta Platforms, Inc.

Nee. U roept Unipile aan met uw API-sleutel en het account_id van elke gekoppelde gebruiker. Gebruikers koppelen hun Facebook-account en de pagina's die ze beheren via de hosted authentication van Unipile: geen Meta-app, App Secret of App Review aan uw kant.

Hij is gebouwd in de geest van de Digital Markets Act: elke gebruiker koppelt zijn eigen account, en Unipile handelt namens hem zonder gebruikersprofielen op te slaan. Meer op onze pagina over de Digital Markets Act.

Ja. Elk gekoppeld account blijft gebonden aan de servicevoorwaarden van Meta. Gebruik de API voor legitieme scenario's zoals klantenservice, CRM en directe gesprekken; spam en ongeoorloofde automatisering kunnen ertoe leiden dat accounts worden beperkt.

Nog vragen? Ons team helpt u graag.

Praat met een expert