Handling Errors

Handling Errors

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.

Error Responses

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.

Error Codes

Code or TypeNameWhat 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

Get a new access token.

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.

Authentication Error Subcodes

 Code  NameWhat 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.

Rate Limiting Error Codes

Visit the Graph API Rate Limits guide for more information about Rate Limiting Error Codes.

    • Related Articles

    • Embedded Signup Flow Errors

      Embedded Signup Flow Errors This guide helps you get acquainted with the different errors that may arise as you embed the signup flow in your website or client portal. Business Manager Account Creation Errors Error (Click the arrow for suggested ...

    • Cloud API Error Codes

      The Cloud API is built on the Graph API, so if you are unfamiliar with handling Graph API error responses, see Graph API's error handling documentation. In general, we recommend that you build your app's error handling logic around code values and ...

    • How to automate API campaigns using Pabbly?

      How Pabbly Works! Pabbly acts as an intermediate between two applications, transferring data from one app into another. Basically, it works on triggers & actions. A trigger on one app will lead to an action on the other app. Here are some trigger ...

    • API Documentation

      Running an API in Postman is a straightforward process, but it becomes even more useful when you need to include custom headers and a specific JSON request body. In this guide, we'll walk you through the steps to run the WABA API using Postman with a ...

    • Panel Guide

      REQUIREMENTS Table of content ● The prerequisite to apply for WhatsApp Business API ● Apply for WhatsApp Business API ● Restrictions on some companies on applying WhatsApp Business API ● Get Facebook Business Manager ID verified ● Is the "Start ...