The error codes and messages listed in this article might not be up-to-date. For the most updated list of error codes, visit WeChat's documentation here.
Here is a list of WeChat error codes, their possible causes, and suggested solutions:
| Error code | Description | Possible cause and suggested solution |
| -1 | System is busy. Try again later. | System is unavailable at the moment. Please try again later. |
| 0 | Request successful | Request successful |
| 40001 | Incorrect AppSecret or invalid access_token. Check the accuracy of AppSecret or check whether the API is called for a proper Official Account. | Incorrect AppSecret or invalid access_token. Please check the accuracy of AppSecret or check whether the API is called for a proper WeChat Official Account. |
| 40002 | Invalid credential type | Invalid credential type |
| 40003 | Invalid OpenID. Check whether the OpenID (the user) has followed the Official Account or belongs to another Official Account. | Invalid OpenID. Please check whether the OpenID (the user) has followed the WeChat Official Account or belongs to another WeChat Official Account. |
| 40004 | Invalid media file type | Invalid media file type |
| 40005 | Invalid file type | Invalid file type |
| 40006 | Invalid file size | Invalid file size |
| 40007 | Invalid media file ID | Invalid media file ID |
| 40008 | Invalid message type | Invalid message type |
| 40009 | Invalid image file size | Invalid image file size |
| 40010 | Invalid voice file size | Invalid voice file size |
| 40011 | Invalid video file size | Invalid video file size |
| 40012 | Invalid thumbnail file size | Invalid thumbnail file size |
| 40013 | Invalid AppID. Check whether AppID is correct. Avoid unsupported characters and ensure case sensitivity. | Invalid AppID. Please check if the AppID you have entered is correct. Please avoid using unsupported characters and ensure the ID is case sensitive. |
| 40014 | Invalid access_token. Check the validity of access_token (whether it is expired) or check whether the API is called for a proper Official Account. | Invalid access_token. Please check that the access_token you have entered is valid, or if it has expired. Also, please ensure the API you are calling is for a proper WeChat Official Account. |
| 40015 | Invalid menu type | Invalid menu type |
| 40016 | Invalid number of buttons | Invalid number of buttons |
| 40017 | Invalid button type | Invalid button type |
| 40018 | Invalid button name length | Invalid button name length |
| 40019 | Invalid button KEY length | Invalid button KEY length |
| 40020 | Invalid button URL length | Invalid button URL length |
| 40021 | Invalid menu version | Invalid menu version |
| 40022 | Invalid sub-menu level | Invalid sub-menu level |
| 40023 | Invalid number of sub-menu buttons | Invalid number of sub-menu buttons |
| 40024 | Invalid sub-menu button type | Invalid sub-menu button type |
| 40025 | Invalid sub-menu button name length | Invalid sub-menu button name length |
| 40026 | Invalid sub-menu button KEY length | Invalid sub-menu button KEY length |
| 40027 | Invalid sub-menu button URL length | Invalid sub-menu button URL length |
| 40028 | Invalid custom menu user | Invalid custom menu user |
| 40029 | Invalid oauth_code | Invalid oauth_code |
| 40030 | Invalid refresh_token | Invalid refresh_token |
| 40031 | Invalid openid list | Invalid openid list |
| 40032 | Invalid openid list length | Invalid openid list length |
| 40033 | Invalid request characters that are expressed in the form of \uxxxx | Invalid request characters that are expressed in the form of \uxxxx |
| 40035 | Invalid parameter | Invalid parameter |
| 40038 | Invalid request format | Invalid request format |
| 40039 | Invalid URL length | Invalid URL length |
| 40048 | Invalid URL | Invalid URL |
| 40050 | Invalid group ID | Invalid group ID |
| 40051 | Invalid group name | Invalid group name |
| 40060 | The specified article_idx is invalid when deleting an article | The specified article_idx is invalid when deleting an article |
| 40117 | Invalid group name | Invalid group name |
| 40118 | Invalid media_id size | Invalid media_id size |
| 40119 | Invalid button type | Invalid button type |
| 40120 | Invalid sub-button type | Invalid sub-button type |
| 40121 | Invalid media_id type | Invalid media_id type |
| 40125 | Invalid appsecret | Invalid appsecret |
| 40132 | Invalid Weixin ID | Invalid Weixin ID |
| 40137 | Invalid image format | Invalid image format |
| 40155 | Do not add a link to the homepage of another Official Account | You cannot add a link to the Homepage of another WeChat Official Account |
| 40163 | The oauth_code is already used | The oauth_code is already in use |
| 40243 | The Appsecret has been frozen,Please login MP to unfreeze | The Appsecret is unresponsive. Please sign in to WeChat MP to refresh and try again. |
| 41001 | Parameter access_token is missing | Parameter access_token required |
| 41002 | Parameter appid is missing | Parameter appid is required |
| 41003 | Parameter refresh_token is missing | Parameter refresh_token is required |
| 41004 | Parameter secret is missing | Parameter secret is required |
| 41005 | Media file data is missing | Media file data is required |
| 41006 | Parameter media_id is missing | Parameter media_id is required |
| 41007 | Sub-menu data is missing | Sub-menu data is required |
| 41008 | oauth code is missing | OAuth code is required |
| 41009 | openid is missing | OpenID is required |
| 42001 | access_token expired. Check the validity period of access_token. See Get access_token API in Basic Support for details. | access_token has expired. Please check the validity period of your access_token. View the Get access_token API in Basic Support for more details. |
| 42002 | refresh_token expired | refresh_token expired |
| 42003 | oauth_code expired | oauth_code expired |
| 42007 | Both access_token and refresh_token became invalid because the user modified the Weixin password. Re-authorization is required. | Both access_token and refresh_token are invalid because the user has updated the Weixin password. Reauthorize account and try again. |
| 43001 | Use GET method | Please use GET method |
| 43002 | Use POST method | Please use POST method |
| 43003 | Use HTTPS method | Please use HTTPS method |
| 43004 | Recipient is not a follower | Unable to preform action as the recipient is not a follower |
| 43005 | Recipient is not a friend | Unable to preform action as the recipient is not a friend |
| 43019 | Recipient is in the blacklist | Unable to preform action as the recipient is in your blacklist |
| 44001 | Empty media file | Empty media file |
| 44002 | Empty POST data packet | Empty POST data packet |
| 44003 | Empty article | Empty article |
| 44004 | Empty text message | Empty text message |
| 45001 | Media file size exceeds the limit | Media file size exceeds the limit |
| 45002 | Message length exceeds the limit | Message length exceeds the limit |
| 45003 | Title length exceeds the limit | Title length exceeds the limit |
| 45004 | Description length exceeds the limit | Description length exceeds the limit |
| 45005 | URL length exceeds the limit | URL length exceeds the limit |
| 45006 | Image URL length exceeds the limit | Image URL length exceeds the limit |
| 45007 | Voice file playback timed out | Voice file playback timed out |
| 45008 | Article length exceeds the limit | Article length exceeds the limit |
| 45009 | API calls exceed the limit | API calls exceed the limit |
| 45010 | The number of menus created exceeds the limit | The number of menus created exceeds the limit |
| 45011 | API is called at a high frequency. Try again later. | Your API requests are being called too frequently. Please try again later. |
| 45015 | Response timed out | Response timed out |
| 45016 | System groups cannot be modified | System groups cannot be modified |
| 45017 | Group name exceeds the limit | Group name exceeds the limit |
| 45018 | The number of groups exceeds the limit | The number of groups exceeds the limit |
| 45047 | The number of downstream customer service messages exceeds the limit | The number of downstream customer service messages exceeds the limit |
| 46001 | Media data does not exist | Media data does not exist |
| 46002 | Menu version does not exist | Menu version does not exist |
| 46003 | Menu data does not exist | Menu data does not exist |
| 46004 | User does not exist | User does not exist |
| 47001 | An error occurred while parsing JSON/XML content | An error occurred while parsing JSON/XML content |
| 48001 | Unable to access the API. Check whether the Official has access to the API. See API permissions in the Official Accounts Platform > Developer Center. | Unable to access the API. Check whether the Official has access to the API. See API permissions in the Official Accounts Platform > Developer Center. |
| 48002 | Message rejected by the follower (Receive Messages in the setting options of the Official Account is disabled by the follower) | Message rejected by the follower. Receive Messages in the setting options of the WeChat Official Account is disabled by the follower. |
| 48004 | API is suspended. Log in to mp.weixin.qq.com for details. | API is currently suspended. Sign in to mp.weixin.qq.com for details. |
| 48005 | Assets that are referenced by auto replies and custom menus cannot be deleted via API | Assets that are referenced by auto replies and custom menus cannot be deleted via API |
| 48006 | Number of calls cannot be cleared via API because the number of clears exceeds the limit | Unable to clear the number of calls via API because the number of clears exceeds the limit |
| 48008 | No permission to send this type of message | Unable to send message because you don't have permission to send this type of message |
| 50001 | The user is not authorized to use this API | You are not authorized to use this API |
| 50002 | The user permission is limited probably because the API is suspended due to unauthorized operation | Your user permission is limited. This may be because the API is suspended due to unauthorized operation. |
| 50005 | The user has not followed the Official Account | The user has not followed the WeChat Official Account |
| 61451 | Invalid parameter | Invalid parameter |
| 61452 | Invalid kf_account | Invalid kf_account |
| 61453 | kf_account already exists | kf_account already exists |
| 61454 | kf_acount length exceeds the limit of 10 characters, excluding @ and the Weixin ID of the Official Account after @. | kf_acount length exceeds the limit of 10 characters. This limit excludes the @ and the Weixin ID of the WeChat Official Account after @. |
| 61455 | kf_acount name contains invalid characters (only letters and numbers are allowed) | kf_acount name contains invalid characters. Only letters and numbers are allowed. |
| 61456 | The number of kf_accounts exceeds the limit of 10 | The number of kf_accounts exceeds the limit of 10 |
| 61457 | Invalid profile photo file type | Invalid profile photo file type |
| 61450 | System error | An system error occurred. Please try again later. |
| 61500 | Date format error | Invalid date format |
| 63001 | Empty parameter | Parameter is empty |
| 63002 | Invalid signature | Invalid signature |
| 65301 | No personalized menu corresponding to this menuid exists | There is no personalized menu available for the provided menu ID. Please check the menu ID and try again. |
| 65302 | No appropriate user exists | Unable to find an appropriate user for this request. Please verify the user information and try again |
| 65303 | Cannot create personalized menus without the default menu | Unable to create personalized menus due to missing default menu |
| 65304 | Empty MatchRule | MatchRule is empty |
| 65305 | The number of personalized menus is limited | You have reached the maximum number of personalized menus allowed. Please delete or deactivate any unused menus before creating a new one. |
| 65306 | This account does not support personalized menus | This account does not support personalized menus |
| 65307 | Personalized menu information is empty | Personalized menu information is empty |
| 65308 | There is a button with no response type | The button you have added does not have a valid response type defined |
| 65309 | Personalized menu is disabled | Personalized menu is disabled |
| 65310 | Country is required if province and city are specified | Country is required if province and city are specified |
| 65311 | Province is required if city is specified | Province is required if city is specified |
| 65312 | Invalid country information | Invalid country information |
| 65313 | Invalid province information | Invalid province information |
| 65314 | Invalid city information | Invalid city information |
| 65316 | Up to 3 external redirect URLs can be set in the Official Account menu | You can only set up to 3 external redirect URLs in the WeChat Official Account menu |
| 65317 | Invalid URL | Invalid URL |
| 87009 | Invalid signature | Invalid signature |
| 9001001 | Invalid POST data parameter | Invalid POST data parameter |
| 9001002 | Unavailable remote service | Unavailable remote service |
| 9001003 | Invalid ticket | Invalid ticket |
| 9001004 | Failed to get the user information via Shake Nearby | Unable to get user information via the Shake Nearby feature |
| 9001005 | Failed to get the merchant information | Unable to get merchant information |
| 9001006 | Failed to get the OpenID | Unable to get OpenID |
| 9001007 | Uploaded file is missing | Uploaded file is missing |
| 9001008 | The file type of uploaded asset is invalid | The file type of uploaded asset is invalid |
| 9001009 | The file size of uploaded asset is invalid | The file size of uploaded asset is invalid |
| 9001010 | Upload failed | Unable to upload. Please try again later. |
| 9001020 | Invalid account | Invalid account |
| 9001021 | There is a device with an activation rate of less than 50%. Cannot add a new one. | Unable to add a new device because one or more of your existing devices has an activation rate below 50%. Please review the activation status of your devices and try again once all devices have an activation rate of 50% or higher. |
| 9001022 | The number of devices requested must be greater than 0 | The number of devices requested must be greater than 0 |
| 9001023 | The application for the device ID is already under review | The application for the device ID is currently under review |
| 9001024 | Up to 50 device IDs can be queried at a time | You can only query up to 50 device IDs at a time |
| 9001025 | Invalid device ID | Invalid device ID |
| 9001026 | Invalid page ID | Invalid page ID |
| 9001027 | Invalid page parameter | Invalid page parameter |
| 9001028 | Up to 10 page IDs can be delete at a time | You can only delete up to 10 page IDs at a time |
| 9001029 | The page has been linked to the device. It cannot be deleted unless unlinked from the device. | The page is linked to another device. It cannot be deleted unless it is unlinked from the device. |
| 9001030 | Up to 50 page IDs can be queried at a time | You can only query up to 50 page IDs at a time |
| 9001031 | Invalid time period | Invalid time period |
| 9001032 | The parameter used to save the linking relationship between device and page is invalid | The parameter used to save the linking relationship between device and page is invalid |
| 9001033 | Invalid shop ID | Invalid shop ID |
| 9001034 | Device remarks exceed the limit | Device remarks exceed the limit |
| 9001035 | Invalid device application parameter | Invalid device application parameter |
| 9001036 | Invalid begin value | Invalid begin value |