
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.
GET
graph.facebook.com/debug_token?input_token={USER_ACCESS_TOKEN} applicationUw appis_validtrueexpires_atover 60 dagenlanglevend user tokendata_access_expires_atover 90 dagenverlengd zolang de gebruiker actief isscopes
TOKEN
Geen refresh token: opnieuw controleren, dan opnieuw inloggen
Inhoudsopgave
De basis
Levensduur
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
Koppel het account
Uw gebruiker koppelt zijn Facebook-account of pagina eenmalig via Hosted Auth. Geen Meta-app, geen App Review.
- 2
Roep aan met uw API-sleutel
Stuur
X-API-KEYmee met hetaccount_idvan de gebruiker:GET /v2/{ACCOUNT_ID}/chats. - 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.
| Token | Handelt namens | Hoe u het krijgt | Levensduur en gebruik |
|---|---|---|---|
| User | Een ingelogde persoon | Facebook Login of Graph API Explorer | 1 tot 2 uur, of ongeveer 60 dagen |
| Page | Een Facebook-pagina | /me/accounts met het user token van een beheerder | Volgt het bijbehorende user token |
| App | Uw Meta-app | client_credentials-aanroep, of {APP_ID}|{APP_SECRET} | Alleen server-to-server-aanroepen |
| System user | Uw bedrijf | Business Settings | Verloopt niet, of na 60 dagen |
| Client | Uw app, in clientcode | App Dashboard | Geen 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 beheerderLevensduur en gebruikVolgt het bijbehorende user token
App token
Handelt namensUw Meta-app
Hoe u het krijgt
client_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
- Open
developers.facebook.com/tools/explorer - Kies uw Meta-app en “User Token”
- Voeg de permissies toe die u nodig hebt
- Klik op Generate Access Token en keur goed
Productie, in 4 stappen
Facebook Login in uw Meta-app
- Maak een Meta-app (App ID, App Secret)
- Stuur gebruikers naar
/dialog/oauthmetclient_id,redirect_uri,state - Ze verlenen permissies; u ontvangt een
code - Uw server roept
/oauth/access_tokenaan met decodeen 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.
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).
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.
{ "error": { "type": "OAuthException", "code": 190, "error_subcode": 460, "fbtrace_id": "EJplcsCHuLu" } }
190
Lees error_subcode, bewaar fbtrace_id voor de support van Meta
| Subcode | Betekenis | Wat te doen |
|---|---|---|
| 458 | App niet geïnstalleerd | Gebruiker opnieuw laten inloggen |
| 459 | Gebruiker geblokkeerd door een controle | Gebruiker logt in op facebook.com |
| 460 | Wachtwoord gewijzigd | Gebruiker opnieuw laten inloggen |
| 463 | Token verlopen | Inloggen, dan opnieuw omwisselen |
| 464 | Niet-bevestigde gebruiker | Gebruiker logt in op facebook.com |
| 467 | Ongeldig token | Gebruiker opnieuw koppelen |
| 492 | Geen geschikte rol op de pagina | Nieuw 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_atop. - 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.
| Vraag | Access tokens van Meta | Gekoppeld account bij Unipile |
|---|---|---|
| Wat u opslaat | Eén token per gebruiker, plus een per pagina, beheerder en app | Een account_id per gebruiker en één API-sleutel |
| Wat u bewaakt | expires_at en data_access_expires_at voor elk token | Een status per pagina in metadata.products_connection_status |
| Wat u vernieuwt | Omwisseling naar langlevend of nieuwe login vóór dag 60 | Geen token van Meta om te wisselen |
| Bij fout 190 | Subcode uitlezen en de gebruiker opnieuw laten inloggen | De 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-sleutelWat u bewaakt
Tokens van Meta
expires_at en data_access_expires_at voor elk tokenUnipileEen status per pagina in
metadata.products_connection_statusWat 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.
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
