Common Error Codes

The following table contains a list of common error codes you may encounter when using the Messenger Platform.

Example Error Response

{
  "error": {
    "message": "Invalid OAuth access token.",
    "type": "OAuthException",
    "code": 190,
    "error_subcode": 1234567,
    "fbtrace_id": "BLBz/WZt8dN"
  }
}
Code – SubcodeMessagePossible Solution

199

An unknown error occurred.

Missing permissions can cause this issue.
Your app may need Advanced Access, Business Verification, or permissions.

11357046

Received invalid JSON reply.

The developer is sending a batch of messages containing 2 text messages and 1 video. The messages are all sent successfully, but the endpoint returns an error. Is the object that they are sending causing the problem? There is a system delay in returning the error message.

2

An unexpected error has occurred. Please retry your request later.

When experiencing issues making calls to the Meta social graph, you can check the status of the Meta Developer Platform to determine if there are issues affecting API calls. You might also receive this error if a customer has blocked your business from messaging him or her.

2 – 2018344

Service temporarily unavailable

Privacy ToS not accepted – To use the inbox label API, you need to accept the privacy ToS. Click the link to accept. https://www.facebook.com/100841475479486/inbox/page_contact_tos/

The Page admin must accept the Privacy Terms of Service for Custom Labels.

4

Rate Limit error: Application request limit reached.

Rate Limit error: Too many send requests to phone numbers

Pause requests until current requests drop below the limit.

42018354

Marketing Messages – There has to be a minimum delay between 2 notifications for the given notification

When a Marketing Message bypasses the frequency set in the notification_messages_frequency field.

This error code will not cause your app to be flagged or blocked for abuse. It is okay to ignore this error, but ideally you should keep track of which users you have sent messages to per the agreed cadence, so you can exclude those users from the next batch of broadcast messages.

92018352

User is performing too many actions

When the Marketing Message opt–in request limit has been exceeded.

10

No Permission For Pages Associated to Instant Games.

The User Profile API is not available for PSIDs associated with Instant Game Pages.

101404170

Application does not have permission for this action

When the Page is temporarily restricted from sending Marketing Message opt–in requests.

101893015

(#10) This user has currently stopped notification messages for this topic

When the Page sends a Marketing Message after the user clicks "Stop these messages".

102018336

User Thread Impact

To determine whether there is user thread impact, invoke the User Level Menu API. If you get a valid response, there is no impact. If you get an error message with code 10, subcode 2018336, the thread is impacted.

102534022

This message is sent outside of allowed window.

Apps can only send a message to a customer within 24 hours of receiving the customer's message.

102534077

Cannot verify the connection between the IG account, the logged in user and the page. Please try reconnecting or verify if the user needs 2–factor authentication.

The page and IG account are not linked or 2–factor authentication is not enabled. Add a link to the 2–factor authentication document (It might be in the help center). Advise the user to check the linkage and perhaps link and unlink the page and the IG account to fix the issue.

102018278

This message is sent outside of allowed window. Learn more about the new policy here.

102018065

This message is sent outside of allowed window. You need News Messaging permission to be able to do it.

102018108

This Person Cannot Receive Messages: This person isn't receiving messages from you right now.

100

Bad Parameter Error: Invalid FBID.

Bad Parameter Error: No matching user found.

notification_messages_token is invalid

notification_messages_token has expired

Check to make sure the ID or token you are using is valid.

10033

Unsupported get request. Object with ID * does not exist, cannot be loaded due to missing permissions, or does not support this operation.

Make sure the ID in your request exists and that your app has the proper permissions to access it.

1002018001

No matching user found

1002018008

Failed to fetch the file from the url. Check that the URL is valid, with a valid SSL certificate, valid file size, and that the server is responding fast enough to avoid timeouts.

1002018014

Cannot send both message and state at the same time.

1002018047

Upload attachment failure. A common way to trigger this error is that the provided media type does not match type of file provided int the URL.

1002018074

Possible invalid ID or you do not own the attachment.

Please view Document Source: Attachment Upload API

1002018109

Attachment size exceeds allowable limit

1002018164

Incorrect App ID.

1002018294

Video upload timed out or video is corrupted. Note that if the video can't be fetched within 75 seconds, it will time out.

1002018320

Invalid product id

Check to make sure the product ID you are using in your Product Template is a valid ID and that your app has permission to access it.

1002018328

Product template is not supported below version 8. Use API version 8 or higher to use product templates.

1002534013

The page is not linked to an Instagram account

The Page ID used in your API calls must be for the Facebook Page linked to your Instagram Professional account.

1002534014

No matching Instagram user

Check to make sure the ID you are using is a valid Instagram–scoped ID. Instagram User ID are not supported.

1002534015

Invalid message data

Make sure that the type of data you are sending in your message is allowed for your message type.

1002534025

The comment is invalid for a private reply

Make sure that the type of data you are sending in your private reply is allowed.

1002534029

The business has been blocked from sending messages via the IG Messaging API

Check to make sure you do not have any policy violations that must be rectified before you can send messages using the Messenger Platform.

1002534037

The action is invalid since it's not the thread owner.

You do not have permission to perform the action on this conversation. Check that your app has the correct permissions and access tokens to manage the conversation.

190

Access Token Error: Invalid OAuth access token.

200

Permission Error: Cannot message users who are not admins, developers or testers of the app until pages_messaging permission is reviewed and the app is live.

2001545041

Message Not Sent: This person isn't available right now.

2002018021

Requires phone matching access fee to be paid by this page unless the recipient user is an admin, developer, or tester of the app.

2002018027

Cannot message users who are not admins, developers or testers of the app until pages_messaging_phone_number permission is reviewed and the app is live.

2002018028

Cannot message users who are not admins, developers or testers of the app until pages_messaging permission is reviewed and the app is live.

2002534041

The account owner has disabled access to instagram direct messages.

The owner of the Instagram Professional account has revoked your app's access.

551

User Block Error: This person isn't receiving messages from you right now.

5511545041

This person isn't available right now.

6131893016

Scope of service exceeded: You may not send multiple opt–in requests with the same topic to a user.

When a Page sends more than 1 opt–in request to the user on the same topic.

If a user receives this type of error through opting–in via Send to Messenger, you will need to inform the user on your website that an opt–in request was already sent to Messenger

6132018338

Warning! You are engaging in behavior that may be considered bothersome or abusive by users. You must significantly decrease the rate at which you are sending messages using message tags to this person. Further misuse of API features may result in messaging restrictions being placed on your Page

6132534040

Calls to this api have exceeded the rate limit.

Your app has reached the rate limit. Pause API calls and try again later.

2022

The ability to send commerce messages has been temporarily disabled. This is the result of a feature limit placed after a policy violation.

10303

Account Linking Error: Invalid account_linking_token.

24001

User canceled payment flow

24002

Payment request cannot be processed due to missing privacy url

24005

Failed to get user ID

36103

To onboard creator accounts during Instagram phased rollout

Call the Conversation API with the page access token to check their eligibility: if the API responds with error code 36103 with the message "This IG account is not eligible for API yet" the business is not yet eligible. Source Document: Messenger API support for Instagram Rollout

2018144

Could not send Instant Game message to the user at this time, only 5 notifications can be sent to a user within 10 days since they last played.

Pause your requests until the number of requests falls below the limit.

2018154

Messenger Extensions unexpected error

2018163

Begin Share Param Validation Error

2018166

Permission not valid to call the SDK API

2018171

Only available to Primary and Secondary Receivers.

2018218

No profile available for this user.

Currently, the User Profile API does not support retrieving profile information for Messenger accounts that were created using a phone number. Please check Source Document: User Profile –– Profile Info (User Profile API)

2018234

Denying visibility of any secondary receiver to another secondary receiver other than itself.

2018247

Insufficient permission to access user profile.

The app calling the User Profile API has not been granted the permissions needed to access one or more of the requested fields. For more information, see Available Profile Filelds.

2018300

Message failed to send because another app is controlling this thread now.

2018321

The chat is currently controlled by Messenger while the user is in an automated question and answer flow. Please wait for the flow to finish before trying again.

2071010

This SDK method is not supported on this Messenger client. Please upgrade

2071011

Messenger Extensions are not enabled – could be "messenger_extensions" was not set on a url, the domain was not added to the allow list or this is an outdated version of Messenger client

2071014

Invalid MessageContent provided to SDK API call

2071015

Invalid title string provided in message content

2071016

Invalid subtitle string provided in message content

2071017

Invalid image URL provided in message content

2071018

Invalid item URL provided in message content

2071019

Invalid button data provided in message content

2071020

URL data is missing in message content. Please provide item_url, button_url or both

2071021

sharingType provided in beginShareFlow call is not valid

2071022

Invalid attachment in begin share flow message content

2071023

Attachment type in message content must be set to template

2071024

Payload is not valid in message content attachment

2071025

Invalid open graph url provided in message content

9000001

This Message has been deleted by the user or the business.

OAuthException

See Also