The error codes and messages listed in this article might not be up-to-date. For the most updated list of error codes, visit the Telegram’s documentation here.
Here is a list of Telegram error codes, their possible causes, and suggested solutions:
| Error code | Code | Description | Possible cause and suggested solution |
| 400 | CHAT_ID_INVALID | The provided chat id is invalid. | The provided chat ID is invalid. Please double-check the chat ID format and ensure it corresponds to an existing chat. |
| 400 | DATA_INVALID | Encrypted data invalid. | Encrypted data is invalid. Please verify that the data format is correct and that it has not been altered or corrupted. |
| 400 | DATA_TOO_LONG | Data is too long. | The data you provided is too long. Please reduce its size and try again. |
| 400 | ENCRYPTION_DECLINED | The secret chat was declined. | The secret chat was declined. Please check with the other participants. |
| 400 | MSG_WAIT_FAILED | A waiting call returned an error. | A waiting call returned an error. Please try again. |
| 400 | FILE_EMPTY | An empty file was provided. | The provided chat ID is invalid. Please verify the ID and try again. |
| 400 | MD5_CHECKSUM_INVALID | The MD5 checksums do not match. | The data you provided is too long. Please reduce its size and try again. |
| 400 | ENCRYPTION_DECLINED | The secret chat was declined. | The secret chat was declined. Please check with the other participants. |
| 400 | FILE_EMPTY | An empty file was provided. | An empty file was provided. Please upload a valid file. |
| 400 | MD5_CHECKSUM_INVALID | The MD5 checksums do not match. | The MD5 checksums do not match. Please ensure the file is correct and try again. |
| 400 | MSG_WAIT_FAILED | A waiting call returned an error. | A waiting call returned an error. Please try again. |
| 400 | CHAT_ID_INVALID | The provided chat id is invalid. | The provided chat ID is invalid. Please verify the ID and try again. |
| 400 | DATA_INVALID | Encrypted data invalid. | The encrypted data is invalid. Please check the data format and try again. |
| 400 | ENCRYPTION_DECLINED | The secret chat was declined. | The secret chat was declined. Please check with the other participant. |
| 400 | ENCRYPTION_ID_INVALID | The provided secret chat ID is invalid. | The provided secret chat ID is invalid. Please verify the ID and try again. |
| 400 | MSG_WAIT_FAILED | A waiting call returned an error. | A waiting call returned an error. Please try again. |
| 400 | USER_IS_BLOCKED | You were blocked by this user. | You were blocked by this user and cannot send messages to them. |
| 400 | CHANNEL_INVALID | The provided channel is invalid. | The provided channel is invalid. Please check the channel ID and try again. |
| 400 | CHANNEL_PRIVATE | You haven’t joined this channel/supergroup. | You haven’t joined this channel/supergroup. Please join to access its content. |
| 400 | CHAT_ADMIN_REQUIRED | You must be an admin in this chat to do this. | You must be an admin in this chat to perform this action. |
| 400 | CHAT_RESTRICTED | You can’t send messages in this chat, you were restricted. | You can’t send messages in this chat because you have been restricted. |
| 400 | CHAT_SEND_INLINE_FORBIDDEN | You can’t send inline messages in this group. | You can’t send inline messages in this group. |
| 400 | ENTITY_BOUNDS_INVALID | A specified entity offset or length is invalid, see here » for info on how to properly compute the entity offset/length. | The specified entity offset or length is invalid. Please refer to the documentation for correct values. |
| 400 | INLINE_RESULT_EXPIRED | The inline query expired. | The inline query has expired. Please submit a new inline query to continue. |
| 400 | INPUT_USER_DEACTIVATED | The specified user was deleted. | The specified user has been deleted. You cannot interact with them. |
| 400 | MEDIA_EMPTY | The provided media object is invalid. | The provided media object is invalid. Please upload a valid media file. |
| 400 | MSG_ID_INVALID | Invalid message ID provided. | The provided message ID is invalid. Please check the ID and try again. |
| 400 | PEER_ID_INVALID | The provided peer id is invalid. | The provided peer ID is invalid. Please verify the ID and try again. |
| 400 | QUERY_ID_EMPTY | The query ID is empty. | The query ID is empty. Please provide a valid query ID to proceed. |
| 400 | RESULT_ID_EMPTY | Result ID empty. | Result ID is empty. Ensure you specify a result ID for your request. |
| 400 | RESULT_ID_INVALID | One of the specified result IDs is invalid. | One of the specified result IDs is invalid. Please check the IDs and try again. |
| 400 | SCHEDULE_DATE_TOO_LATE | You can’t schedule a message this far in the future. | You can’t schedule a message this far in the future. Please choose a closer date. |
| 400 | SCHEDULE_TOO_MUCH | There are too many scheduled messages. | There are too many scheduled messages. Please reduce the number of scheduled messages to proceed. |
| 400 | TOPIC_DELETED | The specified topic was deleted. | The specified topic was deleted. You can no longer send messages to this topic. |
| 400 | USER_BANNED_IN_CHANNEL | You’re banned from sending messages in supergroups/channels. | You’re banned from sending messages in supergroups/channels. Please check your permissions. |
| 400 | VOICE_MESSAGES_FORBIDDEN | This user’s privacy settings forbid you from sending voice messages. | This user’s privacy settings forbid you from sending voice messages. |
| 400 | WEBPAGE_CURL_FAILED | Failure while fetching the webpage with cURL. | There was a failure while fetching the webpage with cURL. Please try again later. |
| 400 | WEBPAGE_MEDIA_EMPTY | Webpage media empty. | Webpage media is empty. Ensure the webpage contains media before trying to fetch it. |
| 400 | YOU_BLOCKED_USER | You blocked this user. | You blocked this user. You cannot send messages to them unless you unblock them first. |
| 400 | BOT_PAYMENTS_DISABLED | Please enable bot payments in botfather before calling this method. | Please enable bot payments in BotFather before calling this method. |
| 400 | BROADCAST_PUBLIC_VOTERS_FORBIDDEN | You can’t forward polls with public voters. | You can’t forward polls with public voters. Please ensure the poll settings allow forwarding. |
| 400 | BUTTON_DATA_INVALID | The data of one or more of the buttons you provided is invalid. | The data of one or more of the buttons you provided is invalid. Check the button configuration and try again. |
| 400 | BUTTON_TYPE_INVALID | The type of one or more of the buttons you provided is invalid. | The type of one or more of the buttons you provided is invalid. Ensure all button types are correct. |
| 400 | BUTTON_URL_INVALID | Button URL invalid. | Button URL is invalid. Please check the URL format and try again. |
| 400 | CHANNEL_INVALID | The provided channel is invalid. | The provided channel is invalid. Verify the channel ID or handle and try again. |
| 400 | CHANNEL_PRIVATE | You haven’t joined this channel/supergroup. | You haven’t joined this channel/supergroup. Please join the channel to access its content. |
| 400 | CHAT_ADMIN_REQUIRED | You must be an admin in this chat to do this. | You must be an admin in this chat to do this. Check your permissions and try again. |
| 400 | CHAT_FORWARDS_RESTRICTED | You can’t forward messages from a protected chat. | You can’t forward messages from a protected chat. Please respect the chat’s forwarding restrictions. |
| 400 | CHAT_RESTRICTED | You can’t send messages in this chat, you were restricted. | You can’t send messages in this chat; you were restricted. Contact an admin for more information. |
| 400 | CURRENCY_TOTAL_AMOUNT_INVALID | The total amount of all prices is invalid. | The total amount of all prices is invalid. Please check the individual prices and ensure they add up correctly. |
| 400 | DOCUMENT_INVALID | The specified document is invalid. | The specified document is invalid. Please verify the document format and try again. |
| 400 | EMOTICON_INVALID | The specified emoji is invalid. | The specified emoji is invalid. Please use a valid emoji and try again. |
| 400 | ENTITY_BOUNDS_INVALID | A specified entity offset or length is invalid, see here » for info on how to properly compute the entity offset/length. | A specified entity offset or length is invalid. Check the computation details |
| 400 | EXTERNAL_URL_INVALID | External URL invalid. | The external URL is invalid. Verify the URL format and ensure it is accessible. |
| 400 | FILE_PART_LENGTH_INVALID | The length of a file part is invalid. | The length of a file part is invalid. Check the file part length and adjust it accordingly. |
| 400 | FILE_PARTS_INVALID | The number of file parts is invalid. | The number of file parts is invalid. Ensure you are sending the correct number of parts as required. |
| 400 | FILE_REFERENCE_EMPTY | An empty file reference was specified. | An empty file reference was specified. Ensure the file reference is not empty. |
| 400 | FILE_REFERENCE_EXPIRED | File reference expired, it must be refetched as described in the documentation. | The file reference has expired. It must be refetched as described in the documentation. |
| 400 | GAME_BOT_INVALID | Bots can’t send another bot’s game. | Bots can’t send another bot’s game. Make sure you are sending your own bot’s game. |
| 400 | IMAGE_PROCESS_FAILED | Failure while processing image. | There was a failure while processing the image. Please check the image format and try again. |
| 400 | INPUT_USER_DEACTIVATED | The specified user was deleted. | The specified user was deleted. You cannot interact with this user anymore. |
| 400 | MD5_CHECKSUM_INVALID | The MD5 checksums do not match. | The MD5 checksums do not match. Please verify the file integrity and try resending it. |
| 400 | MEDIA_CAPTION_TOO_LONG | The caption is too long. | The caption is too long. Please shorten the caption to meet the length requirements. |
| 400 | MEDIA_EMPTY | The provided media object is invalid. | The provided media object is invalid. Ensure that you are sending a valid media object. |
| 400 | MEDIA_INVALID | Media invalid. | The media is invalid. Check the media format and content before sending again. |
| 400 | MESSAGE_EMPTY | The provided message is empty. | The provided message is empty. Please enter a message before sending it. |
| 400 | MSG_ID_INVALID | Invalid message ID provided. | Invalid message ID provided. Check the message ID and ensure it exists before sending your request. |
| 400 | PAYMENT_PROVIDER_INVALID | The specified payment provider is invalid. | The specified payment provider is invalid. Make sure you are using a valid payment provider and try again. |
| 400 | PEER_ID_INVALID | The provided peer id is invalid. | The provided peer ID is invalid. Verify the peer ID and ensure it is correct. |
| 400 | PHOTO_EXT_INVALID | The extension of the photo is invalid. | The extension of the photo is invalid. Please use a supported image format and try again. |
| 400 | PHOTO_INVALID_DIMENSIONS | The photo dimensions are invalid. | The photo dimensions are invalid. Adjust the dimensions of the photo to meet the required specifications. |
| 400 | PHOTO_SAVE_FILE_INVALID | Internal issues, try again later. | Internal issues, try again later. If the problem persists, please contact support for assistance. |
| 400 | POLL_ANSWER_INVALID | One of the poll answers is not acceptable. | One of the poll answers is not acceptable. Review the provided answers and ensure they meet the requirements. |
| 400 | POLL_ANSWERS_INVALID | Invalid poll answers were provided. | Invalid poll answers were provided. Check the answers for correctness and format before resubmitting. |
| 400 | POLL_OPTION_DUPLICATE | Duplicate poll options provided. | Duplicate poll options provided. Ensure that all options are unique and try again. |
| 400 | POLL_OPTION_INVALID | Invalid poll option provided. | Invalid poll option provided. Check the options and ensure they meet the guidelines for poll creation. |
| 400 | POLL_QUESTION_INVALID | One of the poll questions is not acceptable. | One of the poll questions is not acceptable. Review the question and ensure it follows the expected format. |
| 400 | QUIZ_CORRECT_ANSWER_INVALID | An invalid value was provided to the correct_answers field. | An invalid value was provided to the correct_answers field. Ensure that the correct answer is specified correctly. |
| 400 | QUIZ_CORRECT_ANSWERS_EMPTY | No correct quiz answer was specified. | No correct quiz answer was specified. Please provide at least one correct answer for the quiz. |
| 400 | QUIZ_CORRECT_ANSWERS_TOO_MUCH | You specified too many correct answers in a quiz, quizzes can only have one right answer! | You specified too many correct answers in a quiz; quizzes can only have one right answer! Please revise your answers. |
| 400 | QUIZ_MULTIPLE_INVALID | Quizzes can’t have the multiple_choice flag set! | Quizzes can’t have the multiple_choice flag set. Please check your quiz settings and adjust accordingly. |
| 400 | REPLY_MARKUP_BUY_EMPTY | Reply markup for buy button empty. | Reply markup for the buy button is empty. Ensure you provide valid markup to enable the buy functionality. |
| 400 | REPLY_MARKUP_INVALID | The provided reply markup is invalid. | The provided reply markup is invalid. Check the format and content of your reply markup. |
| 400 | REPLY_MARKUP_TOO_LONG | The specified reply_markup is too long. | The specified reply_markup is too long. Please shorten the markup to comply with the character limit. |
| 400 | SCHEDULE_BOT_NOT_ALLOWED | Bots cannot schedule messages. | Bots cannot schedule messages. If scheduling is needed, consider using a user account instead. |
| 400 | SCHEDULE_DATE_TOO_LATE | You can’t schedule a message this far in the future. | You can’t schedule a message this far in the future. Adjust the scheduling time to be within the allowed limit. |
| 400 | SCHEDULE_TOO_MUCH | There are too many scheduled messages. | There are too many scheduled messages. Review and remove some scheduled messages before adding new ones. |
| 400 | SEND_AS_PEER_INVALID | You can’t send messages as the specified peer. | You can’t send messages as the specified peer. Verify the peer ID and try again with a valid one. |
| 400 | TOPIC_CLOSED | This topic was closed, you can’t send messages to it anymore. | This topic was closed, and you can’t send messages to it anymore. Consider starting a new topic for discussions. |
| 400 | TOPIC_DELETED | The specified topic was deleted. | The specified topic was deleted. Please choose another topic or create a new one for your discussion. |
| 400 | TTL_MEDIA_INVALID | Invalid media Time To Live was provided. | Invalid media Time To Live (TTL) was provided. Ensure the TTL is set correctly for your media. |
| 400 | USER_BANNED_IN_CHANNEL | You’re banned from sending messages in supergroups/channels. | You’re banned from sending messages in supergroups/channels. Reach out to an admin for clarification or assistance. |
| 400 | USER_IS_BLOCKED | You were blocked by this user. | You were blocked by this user. To send messages, please unblock them first. |
| 400 | USER_IS_BOT | Bots can’t send messages to other bots. | Bots can’t send messages to other bots. Consider sending your message to a user instead. |
| 400 | VIDEO_CONTENT_TYPE_INVALID | The video’s content type is invalid. | The video’s content type is invalid. Please check the video format and try again. |
| 400 | VOICE_MESSAGES_FORBIDDEN | This user’s privacy settings forbid you from sending voice messages. | This user’s privacy settings forbid you from sending voice messages. Consider sending a text message instead. |
| 400 | WEBDOCUMENT_MIME_INVALID | Invalid webdocument mime type provided. | Invalid web document mime type provided. Check the mime type and provide a valid one. |
| 400 | WEBPAGE_CURL_FAILED | Failure while fetching the webpage with cURL. | Failure while fetching the webpage with cURL. Check the URL and ensure it’s accessible. |
| 400 | WEBPAGE_MEDIA_EMPTY | Webpage media empty. | Webpage media is empty. Ensure that the webpage has media content available for preview. |
| 400 | WEBPAGE_NOT_FOUND | A preview for the specified webpage url could not be generated. | A preview for the specified webpage URL could not be generated. Verify the URL for accuracy. |
| 400 | WEBPAGE_URL_INVALID | The specified webpage url is invalid. | The specified webpage URL is invalid. Please check the URL format and try again. |
| 400 | YOU_BLOCKED_USER | You blocked this user. | You blocked this user. To send messages, please unblock them first. |
| 400 | ADMIN_RIGHTS_EMPTY | The chatAdminRights constructor passed in keyboardButtonRequestPeer.peer_type.user_admin_rights has no rights set (i.e. flags is 0). | The chatAdminRights constructor has no rights set. Please specify the required admin rights. |
| 400 | BOT_DOMAIN_INVALID | Bot domain invalid. | Bot domain invalid. Ensure the domain is correct and try again. |
| 400 | BOT_INVALID | This is not a valid bot. | This is not a valid bot. Check the bot credentials and try again. |
| 400 | BUTTON_DATA_INVALID | The data of one or more of the buttons you provided is invalid. | The data of one or more buttons you provided is invalid. Review the button data and correct any issues. |
| 400 | BUTTON_TYPE_INVALID | The type of one or more of the buttons you provided is invalid. | The type of one or more buttons you provided is invalid. Please verify the button types and try again. |
| 400 | BUTTON_URL_INVALID | Button URL invalid. | Button URL is invalid. Ensure the URL is formatted correctly and accessible. |
| 400 | BUTTON_USER_PRIVACY_RESTRICTED | The privacy setting of the user specified in a inputKeyboardButtonUserProfile button do not allow creating such a button. | The privacy setting of the specified user does not allow creating this button. Check the user’s privacy settings. |
| 400 | CHANNEL_INVALID | The provided channel is invalid. | The provided channel is invalid. Verify the channel ID and try again. |
| 400 | CHANNEL_PRIVATE | You haven’t joined this channel/supergroup. | You haven’t joined this channel/supergroup. Please join the channel to participate. |
| 400 | CHAT_ADMIN_REQUIRED | You must be an admin in this chat to do this. | You must be an admin in this chat to do this. Please contact an admin for assistance. |
| 400 | CHAT_ID_INVALID | The provided chat id is invalid. | The provided chat ID is invalid. Double-check the chat ID and try again. |
| 400 | CHAT_RESTRICTED | You can’t send messages in this chat, you were restricted. | You can’t send messages in this chat, you were restricted. Please check with an admin for details. |
| 400 | DOCUMENT_INVALID | The specified document is invalid. | The specified document is invalid. Please check the document format and try again. |
| 400 | ENCRYPTION_DECLINED | The secret chat was declined. | The secret chat was declined. Please ensure both users agree to start the secret chat. |
| 400 | ENTITIES_TOO_LONG | You provided too many styled message entities. | You provided too many styled message entities. Please reduce the number of entities and try again. |
| 400 | ENTITY_BOUNDS_INVALID | A specified entity offset or length is invalid, see here » for info on how to properly compute the entity offset/length. | A specified entity offset or length is invalid. Check the documentation for details. |
| 400 | ENTITY_MENTION_USER_INVALID | You mentioned an invalid user. | You mentioned an invalid user. Please ensure the user exists and is accessible. |
| 400 | FROM_MESSAGE_BOT_DISABLED | Bots can’t use fromMessage min constructors. | Bots can’t use fromMessage min constructors. Adjust your message format and try again. |
| 400 | INPUT_USER_DEACTIVATED | The specified user was deleted. | The specified user was deleted. You can’t interact with this user anymore. |
| 400 | MESSAGE_EMPTY | The provided message is empty. | The provided message is empty. Please add content to your message before sending. |
| 400 | MESSAGE_TOO_LONG | The provided message is too long. | The provided message is too long. Please shorten your message and try again. |
| 400 | MSG_ID_INVALID | Invalid message ID provided. | Invalid message ID provided. Please check the message ID and try again. |
| 400 | PEER_ID_INVALID | The provided peer id is invalid. | The provided peer ID is invalid. Verify the peer ID and ensure it’s correct. |
| 400 | PINNED_DIALOGS_TOO_MUCH | Too many pinned dialogs. | Too many pinned dialogs. Please unpin some dialogs before pinning new ones. |
| 400 | POLL_OPTION_INVALID | Invalid poll option provided. | Invalid poll option provided. Check the poll options and try again. |
| 400 | REPLY_MARKUP_INVALID | The provided reply markup is invalid. | The poll option you provided is invalid. Please select a valid option to proceed. |
| 400 | REPLY_MARKUP_TOO_LONG | The specified reply_markup is too long. | The reply markup you provided is invalid. Check the format and try again. |
| 400 | REPLY_TO_INVALID | The specified reply_to field is invalid. | The reply markup is too long. Please shorten it to fit the required length. |
| 400 | REPLY_TO_USER_INVALID | The replied-to user is invalid. | The specified reply_to field is invalid. Ensure you are replying to a valid message. |
| 400 | SCHEDULE_BOT_NOT_ALLOWED | Bots cannot schedule messages. | The user you are trying to reply to is invalid. Please check the user’s ID and try again. |
| 400 | SCHEDULE_DATE_TOO_LATE | You can’t schedule a message this far in the future. | Bots are not allowed to schedule messages. Please use a user account to schedule your message. |
| 400 | SCHEDULE_STATUS_PRIVATE | Can’t schedule until user is online, if the user’s last seen timestamp is hidden by their privacy settings. | You can’t schedule a message that far in the future. Please select a closer date and time. |
| 400 | SCHEDULE_TOO_MUCH | There are too many scheduled messages. | You can’t schedule a message until the user is online; their last seen timestamp is hidden. |
| 400 | SEND_AS_PEER_INVALID | You can’t send messages as the specified peer. | You have too many scheduled messages. Please reduce the number of scheduled messages. |
| 400 | STORY_ID_INVALID | The specified story ID is invalid. | You cannot send messages as the specified peer. Please verify the peer ID and try again. |
| 400 | TOPIC_CLOSED | This topic was closed, you can’t send messages to it anymore. | The story ID you provided is invalid. Please check the ID and try again. |
| 400 | TOPIC_DELETED | The specified topic was deleted. | This topic has been closed, and you can no longer send messages to it. |
| 400 | USER_BANNED_IN_CHANNEL | You’re banned from sending messages in supergroups/channels. | The specified topic has been deleted. You cannot interact with it anymore. |
| 400 | USER_IS_BLOCKED | You were blocked by this user. | You have been banned from sending messages in this supergroup/channel. |
| 400 | USER_IS_BOT | Bots can’t send messages to other bots. | You have been blocked by this user and cannot send messages to them. |
| 400 | WC_CONVERT_URL_INVALID | WC convert URL invalid. | The WC convert URL is invalid. Please check the URL format and ensure it meets the required specifications. |
| 400 | YOU_BLOCKED_USER | You blocked this user. | You blocked this user. To send a message, please unblock them first in your chat settings. |
| 400 | CHANNEL_PRIVATE | You haven’t joined this channel/supergroup. | You haven’t joined this channel/supergroup. Please join the channel to access its features and messages. |
| 400 | CHAT_ADMIN_REQUIRED | You must be an admin in this chat to do this. | You must be an admin in this chat to do this. Please check your permissions or contact an admin for assistance. |
| 400 | CHAT_FORWARDS_RESTRICTED | You can’t forward messages from a protected chat. | You can’t forward messages from a protected chat. Check the chat settings for forwarding permissions. |
| 400 | ENTITY_BOUNDS_INVALID | A specified entity offset or length is invalid, see here » for info on how to properly compute the entity offset/length. | A specified entity offset or length is invalid. See here » for how to compute it correctly. |
| 400 | MEDIA_CAPTION_TOO_LONG | The caption is too long. | The caption is too long. Please shorten the caption to fit within the allowed character limit. |
| 400 | MEDIA_EMPTY | The provided media object is invalid. | The provided media object is invalid. Please ensure that the media is correctly formatted and try again. |
| 400 | MEDIA_INVALID | Media invalid. | Media invalid. Verify the media format and ensure it’s supported by the platform before resending. |
| 400 | MULTI_MEDIA_TOO_LONG | Too many media files for album. | Too many media files for the album. Please reduce the number of files to fit within the specified limit. |
| 400 | PEER_ID_INVALID | The provided peer id is invalid. | he provided peer ID is invalid. Please double-check the ID and ensure that it corresponds to an active user or chat. |
| 400 | RANDOM_ID_EMPTY | Random ID empty. | Random ID empty. Please provide a valid random ID to proceed with your request. |
| 400 | SCHEDULE_DATE_TOO_LATE | You can’t schedule a message this far in the future. | You can’t schedule a message this far in the future. Please select a date and time closer to the current moment. |
| 400 | SCHEDULE_TOO_MUCH | There are too many scheduled messages. | There are too many scheduled messages. Please reduce the number of scheduled messages before adding more. |
| 400 | END_AS_PEER_INVALID | You can’t send messages as the specified peer. | You can’t send messages as the specified peer. Ensure that the peer ID is valid and that you have permission to send messages as that user. |
| 400 | TOPIC_CLOSED | This topic was closed, you can’t send messages to it anymore. | This topic was closed; you can’t send messages to it anymore. Please check for active topics to engage with. |
| 400 | TOPIC_DELETED | The specified topic was deleted. | The specified topic was deleted. Please verify the topic ID and choose another active topic to communicate in. |
| 400 | USER_BANNED_IN_CHANNEL | You’re banned from sending messages in supergroups/channels. | You’re banned from sending messages in supergroups/channels. Contact an administrator if you believe this is an error. |
| 400 | CHANNEL_INVALID | The provided channel is invalid. | The provided channel is invalid. Please verify the channel ID and ensure it exists before attempting to use it. |
| 400 | CHANNEL_PRIVATE | You haven’t joined this channel/supergroup. | You haven’t joined this channel/supergroup. Please join the channel to access its content and participate in discussions. |
| 400 | CUSTOM_REACTIONS_TOO_MANY | Too many custom reactions were specified. | Too many custom reactions were specified. Please limit your reactions to the allowed number and try again. |
| 400 | DOCUMENT_INVALID | The specified document is invalid. | The specified document is invalid. Ensure that the document format and content are correct before re-uploading it. |
| 400 | MESSAGE_ID_INVALID | The provided message id is invalid. | The provided message ID is invalid. Check the ID for any errors or ensure that it corresponds to an existing message. |
| 400 | MESSAGE_NOT_MODIFIED | The provided message data is identical to the previous message data, the message wasn’t modified. | The provided message data is identical to the previous message data; the message wasn’t modified. Make necessary changes before resending. |
| 400 | MSG_ID_INVALID | Invalid message ID provided. | Invalid message ID provided. Please check the message ID for accuracy and try again. |
| 400 | PEER_ID_INVALID | The provided peer ID is invalid. | The provided peer ID is invalid. Verify the peer ID and ensure the user or chat is accessible. |
| 400 | REACTION_EMPTY | Empty reaction provided. | Empty reaction provided. Please select a valid reaction to proceed with your request. |
| 400 | REACTION_INVALID | The specified reaction is invalid. | The specified reaction is invalid. Ensure that the reaction used is supported and try again. |
| 400 | REACTIONS_TOO_MANY | The message already has exactly reactions_uniq_max reaction emojis, you can’t react with a new emoji, see the docs for more info ». | The message already has exactly reactions_uniq_max reaction emojis. You can’t react with a new emoji. See the documentation for more info. |
| 400 | USER_BANNED_IN_CHANNEL | You’re banned from sending messages in supergroups/channels. | You’re banned from sending messages in supergroups/channels. Please contact an administrator for assistance. |
| 400 | MESSAGE_ID_INVALID | The provided message id is invalid. | The provided message ID is invalid. Check the ID for any errors and try again. |
| 400 | PEER_ID_INVALID | The provided peer id is invalid. | The provided peer ID is invalid. Please verify the ID and ensure the user is reachable. |
| 400 | INPUT_USER_DEACTIVATED | The specified user was deleted. | The specified user was deleted. Please check the user status and confirm if they are still active in the chat. |
| 400 | PEER_ID_INVALID | The provided peer id is invalid. | The provided peer ID is invalid. Please verify the ID and ensure the user is reachable. |
| 400 | REPLY_MESSAGE_ID_INVALID | The specified reply-to message ID is invalid. | The specified reply-to message ID is invalid. Ensure the ID exists in the chat history and try again. |
| 400 | STORY_ID_INVALID | The specified story ID is invalid. | The specified story ID is invalid. Double-check the ID and verify the story’s availability before proceeding. |
| 400 | YOU_BLOCKED_USER | You blocked this user. | You blocked this user. If you want to communicate, please unblock them first to resume messaging. |
| 400 | CHANNEL_INVALID | The provided channel is invalid. | The specified channel is invalid. Please check the channel ID and try again. |
| 400 | CHANNEL_PRIVATE | You haven’t joined this channel/supergroup. | You cannot access this channel or supergroup because you haven’t joined yet. Please join the channel to proceed. |
| 400 | MESSAGE_ID_INVALID | The provided message id is invalid. | The message ID you provided is invalid. Please check the ID and try again. |
| 400 | MESSAGE_POLL_CLOSED | Poll closed. | The poll you are trying to access is closed. You can no longer vote or view the results. |
| 400 | MSG_ID_INVALID | Invalid message ID provided. | The message ID provided is invalid. Please check the ID and try again. |
| 400 | OPTION_INVALID | Invalid option selected. | The option selected is invalid. Please choose a valid option and try again. |
| 400 | OPTIONS_TOO_MUCH | Too many options provided. | There are too many options provided. Please limit the number of options and try again. |
| 400 | PEER_ID_INVALID | The provided peer id is invalid. | The provided peer ID is invalid. Please double-check the ID and try again. |
| 400 | REVOTE_NOT_ALLOWED | You cannot change your vote. | You cannot change your vote at this time. Please ensure you are submitting your response correctly. |
| 400 | QUERY_ID_INVALID | The query ID is invalid. | The query ID is invalid. Please ensure that you are using a correct and unexpired query ID for your request. |
| 403 | USER_IS_BLOCKED | You were blocked by this user. | You were blocked by this user and cannot send messages to them. |
| 403 | USER_DELETED | You can’t send this secret message because the other participant deleted their account. | You can’t send this secret message because the other participant deleted their account. |
| 403 | USER_IS_BLOCKED | You were blocked by this user. | You were blocked by this user and cannot send messages to them. |
| 403 | CHAT_GUEST_SEND_FORBIDDEN | You join the discussion group before commenting, see here » for more info. | You must join the discussion group before commenting. Please see the documentation for more info. |
| 403 | CHAT_SEND_AUDIOS_FORBIDDEN | You can’t send audio messages in this chat. | You can’t send audio messages in this chat. Please check the chat settings or try a different chat. |
| 403 | CHAT_SEND_GAME_FORBIDDEN | You can’t send a game to this chat. | You can’t send a game to this chat. Consider using a different chat or checking the chat’s capabilities. |
| 403 | CHAT_SEND_GIFS_FORBIDDEN | You can’t send gifs in this chat. | You can’t send GIFs in this chat. Please verify if GIF sharing is allowed in this chat. |
| 403 | CHAT_SEND_INLINE_FORBIDDEN | You can’t send inline messages in this group. | You can’t send inline messages in this group. Check the group settings for more information. |
| 403 | CHAT_SEND_MEDIA_FORBIDDEN | You can’t send media in this chat. | You can’t send media in this chat. Please ensure that media sharing is permitted here. |
| 403 | CHAT_SEND_PHOTOS_FORBIDDEN | You can’t send photos in this chat. | You can’t send photos in this chat. Please check the chat’s media sharing policies. |
| 403 | CHAT_SEND_PLAIN_FORBIDDEN | You can’t send non-media (text) messages in this chat. | You can’t send non-media (text) messages in this chat. Ensure the chat allows text messages. |
| 403 | CHAT_SEND_STICKERS_FORBIDDEN | You can’t send stickers in this chat. | You can’t send stickers in this chat. Check the chat settings to see if sticker sharing is allowed. |
| 403 | CHAT_SEND_VOICES_FORBIDDEN | You can’t send voice recordings in this chat. | You can’t send voice recordings in this chat. Please verify the chat’s permissions regarding voice messages. |
| 403 | CHAT_WRITE_FORBIDDEN | You can’t write in this chat. | You can’t write in this chat. Please check if you have permission to send messages here. |
| 403 | CHAT_ADMIN_REQUIRED | You must be an admin in this chat to do this. | You must be an admin in this chat to do this. Contact an admin for assistance with your request. |
| 403 | CHAT_GUEST_SEND_FORBIDDEN | You join the discussion group before commenting, see here » for more info. | You need to join the discussion group before commenting. Please join the group to participate. |
| 403 | CHAT_SEND_AUDIOS_FORBIDDEN | You can’t send audio messages in this chat. | You can’t send audio messages in this chat. Consider using text or other allowed media types instead. |
| 403 | CHAT_SEND_DOCS_FORBIDDEN | You can’t send documents in this chat. | You can’t send documents in this chat. Please check the chat’s media permissions or choose another method to share. |
| 403 | CHAT_SEND_GIFS_FORBIDDEN | You can’t send gifs in this chat. | You can’t send GIFs in this chat. Try sending a different type of media or text message. |
| 403 | CHAT_SEND_MEDIA_FORBIDDEN | You can’t send media in this chat. | You can’t send media in this chat. Verify the chat settings or use another chat for your media. |
| 403 | CHAT_SEND_PHOTOS_FORBIDDEN | You can’t send photos in this chat. | You can’t send photos in this chat. Check the chat permissions or opt for a different messaging format. |
| 403 | CHAT_SEND_PLAIN_FORBIDDEN | You can’t send non-media (text) messages in this chat. | You can’t send non-media (text) messages in this chat. Consider using an appropriate chat for text communication. |
| 403 | CHAT_SEND_POLL_FORBIDDEN | You can’t send polls in this chat. | You can’t send polls in this chat. Try using another chat or communicate your thoughts directly. |
| 403 | CHAT_SEND_STICKERS_FORBIDDEN | You can’t send stickers in this chat. | You can’t send stickers in this chat. Use text or other media types that are allowed. |
| 403 | CHAT_SEND_VIDEOS_FORBIDDEN | You can’t send videos in this chat. | You can’t send videos in this chat. Please check the chat’s media permissions or choose another format. |
| 403 | CHAT_SEND_VOICES_FORBIDDEN | You can’t send voice recordings in this chat. | You can’t send voice recordings in this chat. Consider using text or other allowed media types instead. |
| 403 | CHAT_WRITE_FORBIDDEN | You can’t write in this chat. | You can’t write in this chat. Check your permissions or contact an admin for assistance. |
| 403 | PREMIUM_ACCOUNT_REQUIRED | A premium account is required to execute this action. | A premium account is required to execute this action. Upgrade your account for access to this feature. |
| 403 | USER_IS_BLOCKED | You were blocked by this user. | You were blocked by this user. You cannot send messages until the user unblocks you. |
| 403 | CHAT_ADMIN_REQUIRED | You must be an admin in this chat to do this. | You must be an admin in this chat to do this. Check your role and contact an admin if you need further assistance. |
| 403 | CHAT_GUEST_SEND_FORBIDDEN | You join the discussion group before commenting, see here » for more info. | You need to join the discussion group before commenting. |
| 403 | CHAT_SEND_PLAIN_FORBIDDEN | You can’t send non-media (text) messages in this chat. | You can’t send non-media (text) messages in this chat. Please check the chat settings for allowed message types. |
| 403 | CHAT_WRITE_FORBIDDEN | You can’t write in this chat. | You can’t write in this chat. Verify your permissions or consult with the chat admin for further instructions. |
| 403 | RIVACY_PREMIUM_REQUIRED | You need a Telegram Premium subscription to send a message to this user. | You need a Telegram Premium subscription to send a message to this user. |
| 403 | USER_IS_BLOCKED | You were blocked by this user. | You were blocked by this user. You cannot send messages unless they unblock you first. |
| 403 | CHAT_SEND_MEDIA_FORBIDDEN | You can’t send media in this chat. | You can’t send media in this chat. Check the chat settings or try sending a text message instead. |
| 403 | CHAT_SEND_PHOTOS_FORBIDDEN | You can’t send photos in this chat. | You can’t send photos in this chat. Review the chat’s media sharing settings and adjust as necessary. |
| 403 | CHAT_SEND_VIDEOS_FORBIDDEN | You can’t send videos in this chat. | You can’t send videos in this chat. Ensure that media sharing is permitted before attempting to send a video. |
| 403 | CHAT_WRITE_FORBIDDEN | You can’t write in this chat. | You can’t write in this chat. Please check if you’re authorized to send messages in this chat. |
| 403 | ANONYMOUS_REACTIONS_DISABLED | Sorry, anonymous administrators cannot leave reactions or participate in polls. | Sorry, anonymous administrators cannot leave reactions or participate in polls. Please log in to use these features. |
| 403 | CHAT_WRITE_FORBIDDEN | You can’t write in this chat. | You can’t write in this chat. Ensure you have the necessary permissions or check if the chat has been restricted. |
| 403 | PREMIUM_ACCOUNT_REQUIRED | A premium account is required to execute this action. | A premium account is required to execute this action. Please upgrade your account to access this feature. |
| 406 | CHANNEL_PRIVATE | You haven’t joined this channel/supergroup. | You haven’t joined this channel/supergroup. Please join to participate in the conversation. |
| 406 | TOPIC_CLOSED | This topic was closed, you can’t send messages to it anymore. | This topic was closed; you can’t send messages to it anymore. Consider finding another topic to engage with. |
| 406 | TOPIC_DELETED | The specified topic was deleted. | The specified topic was deleted. Please check for other available topics to participate in. |
| 406 | CHANNEL_PRIVATE | You haven’t joined this channel/supergroup. | You haven’t joined this channel/supergroup. Please join to access its features and messages. |
| 406 | PAYMENT_UNSUPPORTED | A detailed description of the error will be received separately as described | When encountering a PAYMENT_UNSUPPORTED error (406 NOT_ACCEPTABLE), do not display a visible error message to the user. Instead, wait for an updateServiceNotification, which will provide the localized error message to be shown in a UI popup. Remember, if you receive an AUTH_KEY_DUPLICATED error, your session has been invalidated, and you must generate a new auth key and log in again. |
| 406 | PRIVACY_PREMIUM_REQUIRED | You need a Telegram Premium subscription to send a message to this user. | You need a Telegram Premium subscription to send a message to this user. |
| 406 | TOPIC_CLOSED | This topic was closed, you can’t send messages to it anymore. | This topic was closed; you can’t send messages to it anymore. Please select an active topic to engage with. |
| 406 | TOPIC_DELETED | The specified topic was deleted. | The specified topic was deleted. Please choose another active topic to engage with. |
| 420 | SLOWMODE_WAIT_%d | Slowmode is enabled in this chat: wait %d seconds before sending another message to this chat. | Slowmode is enabled in this chat: wait %d seconds before sending another message to this chat. |
| 420 | SLOWMODE_WAIT_%d | Slowmode is enabled in this chat: wait %d seconds before sending another message to this chat. | Slowmode is enabled in this chat: wait %d seconds before sending another message to this chat. |
| 420 | SLOWMODE_WAIT_%d | Slowmode is enabled in this chat: wait %d seconds before sending another message to this chat. | Slowmode is enabled in this chat: wait %d seconds before sending another message to this chat. |
| 420 | SLOWMODE_WAIT_%d | Slowmode is enabled in this chat: wait %d seconds before sending another message to this chat. | Slowmode is enabled in this chat: wait %d seconds before sending another message. |
| 500 | MSG_WAIT_FAILED | A waiting call returned an error. | A waiting call returned an error. Please try again. |
| 500 | MSG_WAIT_FAILED | A waiting call returned an error. | A waiting call returned an error. Please try again. |
| 500 | RANDOM_ID_DUPLICATE | You provided a random ID that was already used. | You provided a random ID that was already used. Please use a unique random ID for your request. |
| 500 | SEND_MEDIA_INVALID | The specified media is invalid. | The specified media is invalid. Please check the media format and try again. |
| 500 | RANDOM_ID_DUPLICATE | You provided a random ID that was already used. | You provided a random ID that was already used. Please ensure your random ID is unique. |
| 500 | MSG_WAIT_FAILED | A waiting call returned an error. | A waiting call returned an error. Please retry your request, and if the problem persists, check for connectivity issues. |
| 500 | RANDOM_ID_DUPLICATE | You provided a random ID that was already used. | You provided a random ID that was already used. Please generate a unique random ID for this request. |
| 500 | RANDOM_ID_DUPLICATE | You provided a random ID that was already used. | You provided a random ID that was already used. Please generate a unique random ID for this request. |