Requests made to our APIs can result in several different error responses. The following document describes the recovery tactics and provides a list of error values with a map to the most common recovery tactic to use.
The following represents a common error response resulting from a failed API request:
{ "error": { "message": "Message describing the error", "type": "OAuthException", "code": 190, "error_subcode": 460, "error_user_title": "A title", "error_user_msg": "A message", "fbtrace_id": "EJplcsCHuLu" } }
message
: A human-readable description of the error.code
: An error code. Common values are listed below, along with common recovery tactics.error_subcode
: Additional information about the error. Common values are listed below.error_user_msg
: The message to display to the user. The language of the message is based on the locale of the API request.error_user_title
: The title of the dialog, if shown. The language of the message is based on the locale of the API request.fbtrace_id
: Internal support identifier. When reporting a bug
related to a Graph API call, include the fbtrace_id
to help us find log data for debugging. However, this ID will expire shortly. To help the support team reproduce your issue, please attach a saved graph explorer session
.Code or Type | Name | What To Do |
---|---|---|
OAuthException |
If no subcode is present, the login status or access token has expired, been revoked, or is otherwise invalid. Get a new access token . If a subcode is present, see the subcode. |
|
102 |
API Session |
If no subcode is present, the login status or access token has expired, been revoked, or is otherwise invalid. Get a new access token . If a subcode is present, see the subcode. |
1 |
API Unknown |
Possibly a temporary issue due to downtime. Wait and retry the operation. If it occurs again, check that you are requesting an existing API. |
2 |
API Service |
Temporary issue due to downtime. Wait and retry the operation. |
3 |
API Method |
Capability or permissions issue. Make sure your app has the necessary capability or permissions to make this call. |
4 |
API Too Many Calls |
Temporary issue due to throttling. Wait and retry the operation, or examine your API request volume. |
17 |
API User Too Many Calls |
Temporary issue due to throttling. Wait and retry the operation, or examine your API request volume. |
10 |
API Permission Denied |
Permission is either not granted or has been removed. Handle the missing permissions . |
190 |
Access token has expired |
|
200-299 |
API Permission (Multiple values depending on permission) |
Permission is either not granted or has been removed. Handle the missing permissions . |
341 |
Application limit reached |
Temporary issue due to downtime or throttling. Wait and retry the operation, or examine your API request volume. |
368 |
Temporarily blocked for policies violations |
Wait and retry the operation. |
506 |
Duplicate Post |
Duplicate posts cannot be published consecutively. Change the content of the post and try again. |
1609005 |
Error Posting Link |
There was a problem scraping data from the provided link. Check the URL and try again. |
Code | Name | What To Do |
---|---|---|
458 |
App Not Installed |
The User has not logged into your app. Reauthenticate the User. |
459 |
User Checkpointed |
The User needs to log in at https://www.facebook.com or https://m.facebook.com to correct an issue. |
460 |
Password Changed |
On iOS 6 and above, if the person logged in using the OS-integrated flow, direct them to Facebook OS settings on the device to update their password. Otherwise, they must log in to the app again. |
463 |
Expired |
Login status or access token has expired, been revoked, or is otherwise invalid. Handle expired access tokens . |
464 |
Unconfirmed User |
The User needs to log in at https://www.facebook.com or https://m.facebook.com to correct an issue. |
467 |
Invalid Access Token |
Access token has expired, been revoked, or is otherwise invalid. Handle expired access tokens . |
492 |
Invalid Session |
User associated with the Page access token does not have an appropriate role on the Page. |
Visit the Graph API Rate Limits guide for more information about Rate Limiting Error Codes.