List of Error Codes for Facebook API

Error Code Table

 

General Errors

 

Errornumber PHP Constant name Error description Generated by methods

0 API_EC_SUCCESS Success (all)

1 API_EC_UNKNOWN An unknown error occurred (all)

2 API_EC_SERVICE Service temporarily unavailable (all)

3 API_EC_METHOD Unknown method

4 API_EC_TOO_MANY_CALLS Application request limit reached (all)

5 API_EC_BAD_IP Unauthorized source IP address (all)

6 API_EC_HOST_API This method must run on api.facebook.com (all)

7 API_EC_HOST_UP This method must run on api-video.facebook.com

8 API_EC_SECURE This method requires an HTTPS connection

9 API_EC_RATE User is performing too many actions

10 API_EC_PERMISSION_DENIED Application does not have permission for this action

11 API_EC_DEPRECATED This method is deprecated

12 API_EC_VERSION This API version is deprecated

13 API_EC_INTERNAL_FQL_ERROR The underlying FQL query made by this API call has encountered an error. Please check that your parameters are correct.

14 API_EC_HOST_PUP This method must run on api-photo.facebook.com

15 API_EC_SESSION_SECRET_NOT_ALLOWED This method call must be signed with the application secret (You are probably calling a secure method using a session secret)

16 API_EC_HOST_READONLY This method cannot be run on this host, which only supports read-only calls

17 API_EC_USER_TOO_MANY_CALLS User request limit reached

18 API_EC_REQUEST_RESOURCES_EXCEEDED This API call could not be completed due to resource limits

Parameter Errors

 

Errornumber PHP Constant name Error description Generated by methods

100 API_EC_PARAM Invalid parameter (all)

101 API_EC_PARAM_API_KEY Invalid API key (all)

102 API_EC_PARAM_SESSION_KEY Session key invalid or no longer valid (all)

103 API_EC_PARAM_CALL_ID Call_id must be greater than previous

104 API_EC_PARAM_SIGNATURE Incorrect signature (all)

105 API_EC_PARAM_TOO_MANY The number of parameters exceeded the maximum for this operation

110 API_EC_PARAM_USER_ID Invalid user id photos.addTag

111 API_EC_PARAM_USER_FIELD Invalid user info field

112 API_EC_PARAM_SOCIAL_FIELD Invalid user field

113 API_EC_PARAM_EMAIL Invalid email

114 API_EC_PARAM_USER_ID_LIST Invalid user ID list

115 API_EC_PARAM_FIELD_LIST Invalid field list

120 API_EC_PARAM_ALBUM_ID Invalid album id

121 API_EC_PARAM_PHOTO_ID Invalid photo id

130 API_EC_PARAM_FEED_PRIORITY Invalid feed publication priority

140 API_EC_PARAM_CATEGORY Invalid category

141 API_EC_PARAM_SUBCATEGORY Invalid subcategory

142 API_EC_PARAM_TITLE Invalid title

143 API_EC_PARAM_DESCRIPTION Invalid description

144 API_EC_PARAM_BAD_JSON Malformed JSON string

150 API_EC_PARAM_BAD_EID Invalid eid

151 API_EC_PARAM_UNKNOWN_CITY Unknown city

152 API_EC_PARAM_BAD_PAGE_TYPE Invalid page type

170 API_EC_PARAM_BAD_LOCALE Invalid locale

180 API_EC_PARAM_BLOCKED_NOTIFICATION This notification was not delieved

190 API_EC_PARAM_ACCESS_TOKEN Invalid OAuth 2.0 Access Token

User Permission Errors

 

Errornumber PHP Constant name Error description Generated by methods

200 API_EC_PERMISSION Permissions error

210 API_EC_PERMISSION_USER User not visible

211 API_EC_PERMISSION_NO_DEVELOPERS Application has no developers. admin.setAppProperties

212 API_EC_PERMISSION_OFFLINE_ACCESS Renewing a session offline requires the extended permission offline_access

220 API_EC_PERMISSION_ALBUM Album or albums not visible

221 API_EC_PERMISSION_PHOTO Photo not visible

230 API_EC_PERMISSION_MESSAGE Permissions disallow message to user

240 API_EC_PERMISSION_MARKUP_OTHER_USER Desktop applications cannot set FBML for other users

250 API_EC_PERMISSION_STATUS_UPDATE Updating status requires the extended permission status_update. users.setStatus

260 API_EC_PERMISSION_PHOTO_UPLOAD Modifying existing photos requires the extended permission photo_upload photos.upload,photos.addTag

261 API_EC_PERMISSION_VIDEO_UPLOAD Modifying existing photos requires the extended permission photo_upload photos.upload,photos.addTag

270 API_EC_PERMISSION_SMS Permissions disallow sms to user.

280 API_EC_PERMISSION_CREATE_LISTING Creating and modifying listings requires the extended permission create_listing

281 API_EC_PERMISSION_CREATE_NOTE Managing notes requires the extended permission create_note.

282 API_EC_PERMISSION_SHARE_ITEM Managing shared items requires the extended permission share_item.

290 API_EC_PERMISSION_EVENT Creating and modifying events requires the extended permission create_event events.create, events.edit

291 API_EC_PERMISSION_LARGE_FBML_TEMPLATE FBML Template isn't owned by your application.

292 API_EC_PERMISSION_LIVEMESSAGE An application is only allowed to send LiveMessages to users who have accepted the TOS for that application. liveMessage.send

293 API_EC_PERMISSION_XMPP_LOGIN Logging in to chat requires the extended permission xmpp_login Integrating with FacebookChat

294 API_EC_PERMISSION_ADS_MANAGEMENT Managing advertisements requires the extended permission ads_management, and a participating API key Ads API

296 API_EC_PERMISSION_CREATE_EVENT Managing events requires the extended permission create_event API#Events_API_Methods

298 API_EC_PERMISSION_READ_MAILBOX Reading mailbox messages requires the extended permission read_mailbox message.getThreadsInFolder

299 API_EC_PERMISSION_RSVP_EVENT RSVPing to events requires the extended permission create_rsvp events.rsvp

Data Editing Errors

 

Errornumber PHP Constant name Error description Generated by methods

300 API_EC_EDIT Edit failure

310 API_EC_EDIT_USER_DATA User data edit failure

320 API_EC_EDIT_PHOTO Photo edit failure

321 API_EC_EDIT_ALBUM_SIZE Album is full

322 API_EC_EDIT_PHOTO_TAG_SUBJECT Invalid photo tag subject

323 API_EC_EDIT_PHOTO_TAG_PHOTO Cannot tag photo already visible on Facebook

324 API_EC_EDIT_PHOTO_FILE Missing or invalid image file

325 API_EC_EDIT_PHOTO_PENDING_LIMIT Too many unapproved photos pending

326 API_EC_EDIT_PHOTO_TAG_LIMIT Too many photo tags pending

327 API_EC_EDIT_ALBUM_REORDER_PHOTO_NOT_IN_ALBUM Input array contains a photo not in the album

328 API_EC_EDIT_ALBUM_REORDER_TOO_FEW_PHOTOS Input array has too few photos

329 API_EC_MALFORMED_MARKUP Template data must be a JSON-encoded dictionary, of the form {'key-1': 'value-1', 'key-2': 'value-2', ...}

330 API_EC_EDIT_MARKUP Failed to set markup

340 API_EC_EDIT_FEED_TOO_MANY_USER_CALLS Feed publication request limit reached

341 API_EC_EDIT_FEED_TOO_MANY_USER_ACTION_CALLS Feed action request limit reached

342 API_EC_EDIT_FEED_TITLE_LINK Feed story title can have at most one href anchor

343 API_EC_EDIT_FEED_TITLE_LENGTH Feed story title is too long

344 API_EC_EDIT_FEED_TITLE_NAME Feed story title can have at most one fb:userlink and must be of the user whose action is being reported

345 API_EC_EDIT_FEED_TITLE_BLANK Feed story title rendered as blank

346 API_EC_EDIT_FEED_BODY_LENGTH Feed story body is too long

347 API_EC_EDIT_FEED_PHOTO_SRC Feed story photo could not be accessed or proxied

348 API_EC_EDIT_FEED_PHOTO_LINK Feed story photo link invalid

350 API_EC_EDIT_VIDEO_SIZE Video file is too large video.upload

351 API_EC_EDIT_VIDEO_INVALID_FILE Video file was corrupt or invalid video.upload

352 API_EC_EDIT_VIDEO_INVALID_TYPE Video file format is not supported video.upload

353 API_EC_EDIT_VIDEO_FILE Missing video file video.upload

354 API_EC_EDIT_VIDEO_NOT_TAGGED User is not tagged in this video

355 API_EC_EDIT_VIDEO_ALREADY_TAGGED User is already tagged in this video

360 API_EC_EDIT_FEED_TITLE_ARRAY Feed story title_data argument was not a valid JSON-encoded array

361 API_EC_EDIT_FEED_TITLE_PARAMS Feed story title template either missing required parameters, or did not have all parameters defined in title_data array

362 API_EC_EDIT_FEED_BODY_ARRAY Feed story body_data argument was not a valid JSON-encoded array

363 API_EC_EDIT_FEED_BODY_PARAMS Feed story body template either missing required parameters, or did not have all parameters defined in body_data array

364 API_EC_EDIT_FEED_PHOTO Feed story photos could not be retrieved, or bad image links were provided

365 API_EC_EDIT_FEED_TEMPLATE The template for this story does not match any templates registered for this application

366 API_EC_EDIT_FEED_TARGET One or more of the target ids for this story are invalid. They must all be ids of friends of the acting user

367 API_EC_EDIT_FEED_MARKUP The template data provided doesn't cover the entire token set needed to publish the story

370 API_EC_USERS_CREATE_INVALID_EMAIL The email address you provided is not a valid email address

371 API_EC_USERS_CREATE_EXISTING_EMAIL The email address you provided belongs to an existing account

372 API_EC_USERS_CREATE_BIRTHDAY The birthday provided is not valid

373 API_EC_USERS_CREATE_PASSWORD The password provided is too short or weak

374 API_EC_USERS_REGISTER_INVALID_CREDENTIAL The login credential you provided is invalid.

375 API_EC_USERS_REGISTER_CONF_FAILURE Failed to send confirmation message to the specified login credential.

376 API_EC_USERS_REGISTER_EXISTING The login credential you provided belongs to an existing account

377 API_EC_USERS_REGISTER_DEFAULT_ERROR Sorry, we were unable to process your registration.

378 API_EC_USERS_REGISTER_PASSWORD_BLANK Your password cannot be blank. Please try another.

379 API_EC_USERS_REGISTER_PASSWORD_INVALID_CHARS Your password contains invalid characters. Please try another.

380 API_EC_USERS_REGISTER_PASSWORD_SHORT Your password must be at least 6 characters long. Please try another.

381 API_EC_USERS_REGISTER_PASSWORD_WEAK Your password should be more secure. Please try another.

382 API_EC_USERS_REGISTER_USERNAME_ERROR Our automated system will not approve this name.

383 API_EC_USERS_REGISTER_MISSING_INPUT You must fill in all of the fields.

384 API_EC_USERS_REGISTER_INCOMPLETE_BDAY You must indicate your full birthday to register.

385 API_EC_USERS_REGISTER_INVALID_EMAIL Please enter a valid email address.

386 API_EC_USERS_REGISTER_EMAIL_DISABLED The email address you entered has been disabled. Please contact [e-mail] with any questions.

387 API_EC_USERS_REGISTER_ADD_USER_FAILED There was an error with your registration. Please try registering again.

388 API_EC_USERS_REGISTER_NO_GENDER Please select either Male or Female.

Authentication Errors

 

Error number PHP Constant name Error description Generated by methods

400 API_EC_AUTH_EMAIL Invalid email address

401 API_EC_AUTH_LOGIN Invalid username or password

402 API_EC_AUTH_SIG Invalid application auth sig

403 API_EC_AUTH_TIME Invalid timestamp for authentication

Session Errors

 

Errornumber PHP Constant name Error description Generated by methods

450 API_EC_SESSION_TIMED_OUT Session key specified has passed its expiration time

451 API_EC_SESSION_METHOD Session key specified cannot be used to call this method

452 API_EC_SESSION_INVALID Session key invalid. This could be because the session key has an incorrect format, or because the user has revoked this session

453 API_EC_SESSION_REQUIRED A session key is required for calling this method

454 API_EC_SESSION_REQUIRED_FOR_SECRET A session key must be specified when request is signed with a session secret

455 API_EC_SESSION_CANNOT_USE_SESSION_SECRET A session secret is not permitted to be used with this type of session key

Application Messaging Errors

 

Error number PHP Constant name Error description Generated by methods

500 API_EC_MESG_BANNED Message contains banned content

501 API_EC_MESG_NO_BODY Missing message body

502 API_EC_MESG_TOO_LONG Message is too long

503 API_EC_MESG_RATE User has sent too many messages

504 API_EC_MESG_INVALID_THREAD Invalid reply thread id

505 API_EC_MESG_INVALID_RECIP Invalid message recipient

510 API_EC_POKE_INVALID_RECIP Invalid poke recipient

511 API_EC_POKE_OUTSTANDING There is a poke already outstanding

512 API_EC_POKE_RATE User is poking too fast

513 API_EC_POKE_USER_BLOCKED User cannot poke via API

FQL Errors

 

Errornumber PHP Constant name Error description Generated by methods

600 FQL_EC_UNKNOWN_ERROR An unknown error occurred in FQL fql.query,fql.multiquery

601 FQL_EC_PARSER_ERROR Error while parsing FQL statement fql.query,fql.multiquery

602 FQL_EC_UNKNOWN_FIELD The field you requested does not exist fql.query,fql.multiquery

603 FQL_EC_UNKNOWN_TABLE The table you requested does not exist fql.query,fql.multiquery

604 FQL_EC_NO_INDEX Your statement is not indexable fql.query,fql.multiquery

605 FQL_EC_UNKNOWN_FUNCTION The function you called does not exist fql.query,fql.multiquery

606 FQL_EC_INVALID_PARAM Wrong number of arguments passed into the function fql.query,fql.multiquery

607 FQL_EC_INVALID_FIELD FQL field specified is invalid in this context. fql.query*,fql.multiquery

608 FQL_EC_INVALID_SESSION An invalid session was specified fql.query,fql.multiquery

609 FQL_EC_UNSUPPORTED_APP_TYPE FQL field specified is invalid in this context. fql.query*,fql.multiquery

610 FQL_EC_SESSION_SECRET_NOT_ALLOWED FQL field specified is invalid in this context. fql.query*,fql.multiquery

611 FQL_EC_DEPRECATED_TABLE FQL field specified is invalid in this context. fql.query*,fql.multiquery

612 FQL_EC_EXTENDED_PERMISSION The stream requires an extended permission fql.query,fql.multiquery

613 FQL_EC_RATE_LIMIT_EXCEEDED Calls to stream have exceeded the rate of 100 calls per 600 seconds. fql.query,fql.multiquery

614 FQL_EC_UNRESOLVED_DEPENDENCY Unresolved dependency in multiquery fql.multiquery

615 FQL_EC_INVALID_SEARCH This search is invalid fql.query,fql.multiquery

617 FQL_EC_TOO_MANY_FRIENDS_FOR_PRELOAD The user you queried against has too many friends to be used with Preload FQL, in order to avoid out of memory errors fql.query,fql.multiquery

* This error is returned when the field name is sometimes valid, but not all the time. For example, if you run fql.query on the Metrics FQL table, you can get this error because some metrics are queryable only over the daily period, as opposed to the weekly or monthly periods.

 

Ref Errors

 

Error number PHP Constant name Error description Generated by methods

700 API_EC_REF_SET_FAILED Unknown failure in storing ref data. Please try again.

Application Integration Errors

 

Errornumber PHP Constant name Error description Generated by methods

750 API_EC_FB_APP_UNKNOWN_ERROR Unknown Facebook application integration failure.

751 API_EC_FB_APP_FETCH_FAILED Fetch from remote site failed.

752 API_EC_FB_APP_NO_DATA Application returned no data. This may be expected or represent a connectivity error.

753 API_EC_FB_APP_NO_PERMISSIONS Application returned user had invalid permissions to complete the operation.

754 API_EC_FB_APP_TAG_MISSING Application returned data, but no matching tag found. This may be expected.

755 API_EC_FB_APP_DB_FAILURE The database for this object failed.

Data Store API Errors

 

Errornumber PHP Constant name Error description Generated by methods

800 API_EC_DATA_UNKNOWN_ERROR Unknown data store API error

801 API_EC_DATA_INVALID_OPERATION Invalid operation

802 API_EC_DATA_QUOTA_EXCEEDED Data store allowable quota was exceeded

803 API_EC_DATA_OBJECT_NOT_FOUND Specified object cannot be found

804 API_EC_DATA_OBJECT_ALREADY_EXISTS Specified object already exists

805 API_EC_DATA_DATABASE_ERROR A database error occurred. Please try again

806 API_EC_DATA_CREATE_TEMPLATE_ERROR Unable to add FBML template to template database. Please try again.

807 API_EC_DATA_TEMPLATE_EXISTS_ERROR No active template bundle with that ID or handle exists.

808 API_EC_DATA_TEMPLATE_HANDLE_TOO_LONG Template bundle handles must contain less than or equal to 32 characters.

809 API_EC_DATA_TEMPLATE_HANDLE_ALREADY_IN_USE Template bundle handle already identifies a previously registered template bundle, and handles can not be reused.

810 API_EC_DATA_TOO_MANY_TEMPLATE_BUNDLES Application has too many active template bundles, and some must be deactivated before new ones can be registered.

811 API_EC_DATA_MALFORMED_ACTION_LINK One of more of the supplied action links was improperly formatted.

812 API_EC_DATA_TEMPLATE_USES_RESERVED_TOKEN One or more of your templates is using a token reserved by Facebook, such as {*mp3*} or {*video*}.

Mobile/SMS Errors

 

Error number PHP Constant name Error description Generated by methods

850 API_EC_SMS_INVALID_SESSION Invalid sms session.

851 API_EC_SMS_MSG_LEN Invalid sms message length.

852 API_EC_SMS_USER_QUOTA Over user daily sms quota.

853 API_EC_SMS_USER_ASLEEP Unable to send sms to user at this time.

854 API_EC_SMS_APP_QUOTA Over application daily sms quota/rate limit.

855 API_EC_SMS_NOT_REGISTERED User is not registered for Facebook Mobile Texts

856 API_EC_SMS_NOTIFICATIONS_OFF User has SMS notifications turned off

857 API_EC_SMS_CARRIER_DISABLE SMS application disallowed by mobile operator

Application Information Errors

 

Error number PHP Constant name Error description Generated by methods

900 API_EC_NO_SUCH_APP No such application exists.

Batch API Errors

 

Errornumber PHP Constant name Error description Generated by methods

950 API_BATCH_TOO_MANY_ITEMS Each batch API can not contain more than 20 items

951 API_EC_BATCH_ALREADY_STARTED begin_batch already called, please make sure to call end_batch first.

952 API_EC_BATCH_NOT_STARTED end_batch called before begin_batch.

953 API_EC_BATCH_METHOD_NOT_ALLOWED_IN_BATCH_MODE This method is not allowed in batch mode.

Events API Errors

 

Error number PHP Constant name Error description Generated by methods

1000 API_EC_EVENT_INVALID_TIME Invalid time for an event. events.edit

1001 API_EC_EVENT_NAME_LOCKED You are no longer able to change the name of this event. events.edit

Info Section Errors

 

Error number PHP Constant name Error description Generated by methods

1050 API_EC_INFO_NO_INFORMATION No information has been set for this user profile.setInfo

1051 API_EC_INFO_SET_FAILED Setting info failed. Check the formatting of your info fields. profile.setInfo

LiveMessage Errors

 

Errornumber PHP Constant name Error description Generated by methods

1100 API_EC_LIVEMESSAGE_SEND_FAILED An error occurred while sending the LiveMessage. liveMessage.send

1101 API_EC_LIVEMESSAGE_EVENT_NAME_TOO_LONG The event_name parameter must be no longer than 128 bytes. liveMessage.send

1102 API_EC_LIVEMESSAGE_MESSAGE_TOO_LONG The message parameter must be no longer than 1024 bytes. liveMessage.send

Chat Errors

 

Error number PHP Constant name Error description Generated by methods

1200 API_EC_CHAT_SEND_FAILED An error occurred while sending the message.

Facebook Page Errors

 

Error number PHP Constant name Error description Generated by methods

1201 API_EC_PAGES_CREATE You have created too many pages

Facebook Links Errors

 

Error number PHP Constant name Error description Generated by methods

1500 API_EC_SHARE_BAD_URL The url you supplied is invalid

Facebook Notes Errors

 

Error number PHP Constant name Error description Generated by methods

1600 API_EC_NOTE_CANNOT_MODIFY The user does not have permission to modify this note.

Comment Errors

 

Errornumber PHP Constant name Error description Generated by methods

1700 API_EC_COMMENTS_UNKNOWN An unknown error has occurred.

1701 API_EC_COMMENTS_POST_TOO_LONG The specified post was too long.

1702 API_EC_COMMENTS_DB_DOWN The comments database is down.

1703 API_EC_COMMENTS_INVALID_XID The specified xid is not valid. xids can only contain letters, numbers, and underscores

1704 API_EC_COMMENTS_INVALID_UID The specified user is not a user of this application

1705 API_EC_COMMENTS_INVALID_POST There was an error during posting.

1706 API_EC_COMMENTS_INVALID_REMOVE While attempting to remove the post.