606 errors 18 parameterized 11 MTProto codes

How gogram surfaces them

In Go these come back as *gogram.ErrResponseCode. Match on .Message for the exact code, read .Description for the formatted human text, and inspect .AdditionalInfo for the parsed integer when the code ends in _X.

Source: errors.go.

Filter

HTTP 400 — Bad Request (528)

The server rejected the request payload — a parameter is missing, malformed, or fails a server-side invariant.

2FA_CONFIRM_WAIT_X Authentication — You'll be able to reset your account in %v seconds. If not, account will be deleted in 1 week for security reasons. ABOUT_TOO_LONG Other — About string too long. ACTIVE_USER_REQUIRED Other — The method is only available to already activated users. ADDRESS_INVALID Other — The specified geopoint address is invalid. ADMINS_TOO_MUCH Flood / Rate limits — There are too many admins. ADMIN_ID_INVALID Permissions / Forbidden — The specified admin ID is invalid. ADMIN_RANK_EMOJI_NOT_ALLOWED Permissions / Forbidden — An admin rank cannot contain emojis. ADMIN_RANK_INVALID Permissions / Forbidden — The specified admin rank is invalid. ADMIN_RIGHTS_EMPTY Permissions / Forbidden — The admin rights configuration has no rights set. ALBUM_PHOTOS_TOO_MANY Other — You have uploaded too many profile photos, delete some before retrying. ANONYMOUS_REACTIONS_DISABLED Other — Sorry, anonymous administrators cannot leave reactions or participate in polls. API_ID_INVALID Server / Internal — API ID invalid. API_ID_PUBLISHED_FLOOD Server / Internal — This API ID was published somewhere, you can't use it now. ARTICLE_TITLE_EMPTY Other — The title of the article is empty. AUDIO_CONTENT_URL_EMPTY Media / Files — The remote URL specified in the content field is empty. AUDIO_TITLE_EMPTY Media / Files — An empty audio title was provided. AUTH_BYTES_INVALID Authentication — The provided authorization is invalid. AUTH_RESTART Authentication — Restart the authorization process. AUTOARCHIVE_NOT_AVAILABLE Other — The autoarchive setting is not available at this time; please check the client configuration. BANK_CARD_NUMBER_INVALID Other — The specified card number is invalid. BANNED_RIGHTS_INVALID Other — You provided some invalid flags in the banned rights. BASE_PORT_LOC_INVALID Other — Base port location invalid. BOOSTS_EMPTY Other — No boost slots were specified. BOOSTS_REQUIRED Other — The specified channel must first be boosted by its users in order to perform this action. BOOST_NOT_MODIFIED Boost / Levels — You are already boosting the specified channel. BOOST_PEER_INVALID Boost / Levels — The specified boost_peer is invalid. BOTS_TOO_MUCH Flood / Rate limits — There are too many bots in this chat/channel. BOT_APP_INVALID Bots & Inline — The specified bot app is invalid. BOT_APP_SHORTNAME_INVALID Bots & Inline — The specified bot app short name is invalid. BOT_CHANNELS_NA Bots & Inline — Bots can't edit admin privileges. BOT_COMMANDS_TOO_MUCH Flood / Rate limits — The provided commands are too many. BOT_COMMAND_DESCRIPTION_INVALID Bots & Inline — The specified command description is invalid. BOT_COMMAND_INVALID Bots & Inline — The specified command is invalid. BOT_DOMAIN_INVALID Bots & Inline — Bot domain invalid. BOT_GAMES_DISABLED Bots & Inline — Bot games cannot be used in this type of chat. BOT_GROUPS_BLOCKED Bots & Inline — This bot can't be added to groups. BOT_INLINE_DISABLED Bots & Inline — This bot can't be used in inline mode. BOT_INVALID Bots & Inline — This is not a valid bot. BOT_METHOD_INVALID Bots & Inline — The API access for bot users is restricted. This method cannot be executed as a bot. BOT_MISSING Bots & Inline — Only bots can call this method. BOT_ONESIDE_NOT_AVAIL Bots & Inline — Bots can't pin messages in PM just for themselves. BOT_PAYMENTS_DISABLED Bots & Inline — Please enable bot payments in BotFather before calling this method. BOT_POLLS_DISABLED Bots & Inline — You cannot create polls under a bot account. BOT_SCORE_NOT_MODIFIED Bots & Inline — The score wasn't modified. BOT_WEBVIEW_DISABLED Bots & Inline — A webview cannot be opened in the specified conditions. BROADCAST_CALLS_DISABLED Channels & Chats — Broadcast calls are disabled for this chat/channel. BROADCAST_ID_INVALID Channels & Chats — Broadcast ID invalid. BROADCAST_REQUIRED Channels & Chats — This method can only be called on a channel. BUTTON_DATA_INVALID Other — The data of one or more of the buttons you provided is invalid. BUTTON_TEXT_INVALID Other — The specified button text is invalid. BUTTON_TYPE_INVALID Other — The type of one or more of the buttons you provided is invalid. BUTTON_URL_INVALID Other — Button URL invalid. BUTTON_USER_INVALID Other — The user_id passed to the button is invalid. CALL_ALREADY_ACCEPTED Calls / Voice / Video — The call was already accepted. CALL_ALREADY_DECLINED Calls / Voice / Video — The call was already declined. CALL_OCCUPY_FAILED Calls / Voice / Video — The call failed because the user is already making another call. CALL_PEER_INVALID Calls / Voice / Video — The provided call peer object is invalid. CALL_PROTOCOL_COMPAT_LAYER_INVALID Calls / Voice / Video — The other side of the call does not support any of the VoIP protocols supported by the local client. CALL_PROTOCOL_FLAGS_INVALID Calls / Voice / Video — Call protocol flags invalid. CDN_METHOD_INVALID Other — You can't call this method in a CDN DC. CHANNELS_ADMIN_LOCATED_TOO_MUCH Flood / Rate limits — The user has reached the limit of public geogroups. CHANNELS_ADMIN_PUBLIC_TOO_MUCH Flood / Rate limits — You're admin of too many public channels, make some channels private to change the username of this channel. CHANNEL_ADD_INVALID Channels & Chats — The specified channel is invalid. CHANNEL_FORUM_MISSING Channels & Chats — This supergroup is not a forum. CHANNEL_ID_INVALID Channels & Chats — The specified supergroup ID is invalid. CHANNEL_INVALID Channels & Chats — The provided channel is invalid. CHANNEL_PARTICIPANT_MISSING Channels & Chats — The current user is not in the channel. CHANNEL_TOO_BIG Channels & Chats — This channel has too many participants (>1000) to be deleted. CHANNEL_TOO_LARGE Channels & Chats — Channel is too large to be deleted. CHATLIST_EXCLUDE_INVALID Other — The specified exclude_peers are invalid. CHAT_ABOUT_NOT_MODIFIED Channels & Chats — About text has not changed. CHAT_ABOUT_TOO_LONG Channels & Chats — Chat about too long. CHAT_ADMIN_INVITE_REQUIRED Permissions / Forbidden — You do not have the rights to do this. CHAT_ADMIN_REQUIRED Permissions / Forbidden — You must be an admin in this chat to do this. CHAT_DISCUSSION_UNALLOWED Channels & Chats — You can't enable forum topics in a discussion group linked to a channel. CHAT_GET_FAILED Channels & Chats — Chat retrieval failed. CHAT_ID_EMPTY Channels & Chats — The provided chat ID is empty. CHAT_ID_GENERATE_FAILED Channels & Chats — Failure while generating the chat ID. CHAT_ID_INVALID Channels & Chats — The provided chat id is invalid. CHAT_INVALID Channels & Chats — Invalid chat. CHAT_INVITE_PERMANENT Channels & Chats — You can't set an expiration date on permanent invite links. CHAT_LINK_EXISTS Channels & Chats — The chat is public, you can't hide the history to new users. CHAT_PUBLIC_REQUIRED Channels & Chats — You can only enable join requests in public groups. CHAT_REVOKE_DATE_UNSUPPORTED Channels & Chats — Date restrictions are not available for using with non-user peers. CHAT_TITLE_EMPTY Channels & Chats — No chat title provided. CHAT_TOO_BIG Channels & Chats — This method is not available for groups that are too big. CHP_CALL_FAIL Other — The statistics cannot be retrieved at this time. CODE_EMPTY Authentication — The provided code is empty. CODE_HASH_INVALID Authentication — Code hash invalid. CODE_INVALID Authentication — Code invalid. COLOR_INVALID Other — The specified color palette ID was invalid. CONNECTION_API_ID_INVALID Server / Internal — The provided API id is invalid. CONNECTION_APP_VERSION_EMPTY Server / Internal — App version is empty. CONNECTION_DEVICE_MODEL_EMPTY Server / Internal — Device model empty. CONNECTION_LANG_PACK_INVALID Server / Internal — The specified language pack is not valid. CONNECTION_LAYER_INVALID Server / Internal — Layer invalid. CONNECTION_NOT_INITED Server / Internal — Connection not initialized. CONNECTION_SYSTEM_EMPTY Server / Internal — Connection system empty. CONNECTION_SYSTEM_LANG_CODE_EMPTY Server / Internal — The system language string was empty during connection. CONTACT_ADD_MISSING Users & Peers — Contact to add is missing. CONTACT_ID_INVALID Users & Peers — The provided contact ID is invalid. CONTACT_MISSING Users & Peers — The specified user is not a contact. CONTACT_NAME_EMPTY Users & Peers — Contact name empty. CONTACT_REQ_MISSING Users & Peers — Missing contact request. CREATE_CALL_FAILED Other — An error occurred while creating the call. CURRENCY_TOTAL_AMOUNT_INVALID Other — The total amount of all prices is invalid. CUSTOM_REACTIONS_TOO_MANY Other — Too many custom reactions were specified. DATA_INVALID Other — Encrypted data invalid. DATA_JSON_INVALID Other — The provided JSON data is invalid. DATA_TOO_LONG Other — Data too long. DATE_EMPTY Other — Date empty. DC_ID_INVALID Other — The provided DC ID is invalid. DH_G_A_INVALID Other — g_a invalid. DOCUMENT_INVALID Media / Files — The specified document is invalid. EMAIL_HASH_EXPIRED Authentication — Email hash expired. EMAIL_INSTALL_MISSING Authentication — No email was set up for this account. EMAIL_INVALID Authentication — The specified email is invalid. EMAIL_NOT_SETUP Authentication — Login email not set up. EMAIL_UNCONFIRMED Authentication — Email unconfirmed. EMAIL_UNCONFIRMED_X Authentication · PARAM — Email unconfirmed, the length of the code must be %v. EMAIL_VERIFY_EXPIRED Authentication — The verification email has expired. EMOJI_INVALID Other — The specified theme emoji is invalid. EMOJI_MARKUP_INVALID Other — The specified video_emoji_markup was invalid. EMOJI_NOT_MODIFIED Other — The theme wasn't changed. EMOTICON_EMPTY Other — The emoji is empty. EMOTICON_INVALID Other — The specified emoji is invalid. EMOTICON_STICKERPACK_MISSING Other — The emoji cannot be empty. ENCRYPTED_MESSAGE_INVALID Other — Encrypted message invalid. ENCRYPTION_ALREADY_ACCEPTED Other — Secret chat already accepted. ENCRYPTION_ALREADY_DECLINED Other — The secret chat was already declined. ENCRYPTION_DECLINED Other — The secret chat was declined. ENCRYPTION_ID_INVALID Other — The provided secret chat ID is invalid. ENCRYPTION_OCCUPY_FAILED Other — Internal server error while accepting secret chat. ENTITIES_TOO_LONG Other — You provided too many styled message entities. ENTITY_BOUNDS_INVALID Other — A specified entity offset or length is invalid. ENTITY_MENTION_USER_INVALID Other — You mentioned an invalid user. ERROR_TEXT_EMPTY Other — The provided error message is empty. EXPIRE_DATE_INVALID Other — The specified expiration date is invalid. EXPORT_CARD_INVALID Other — Provided card is invalid. EXTERNAL_URL_INVALID Other — External URL invalid. FIELD_NAME_EMPTY Other — A required field is missing. FIELD_NAME_INVALID Other — A provided field is invalid. FILEREF_UPGRADE_NEEDED Other — The client has to be updated in order to support file references. FILE_CONTENT_TYPE_INVALID Media / Files — File content-type is invalid. FILE_EMPTY Media / Files — An empty file was provided. FILE_EMTPY Media / Files — An empty file was provided. FILE_ID_INVALID Media / Files — The provided file id is invalid. FILE_PARTS_INVALID Media / Files — The number of file parts is invalid. FILE_PART_EMPTY Media / Files — The provided file part is empty. FILE_PART_INVALID Media / Files — The file part number is invalid. FILE_PART_LENGTH_INVALID Media / Files — The length of a file part is invalid. FILE_PART_SIZE_CHANGED Media / Files — Provided file part size has changed. FILE_PART_SIZE_INVALID Media / Files — The provided file part size is invalid. FILE_PART_TOO_BIG Media / Files — The uploaded file part is too big. FILE_PART_X_MISSING Media / Files · PARAM — Part %v of the file is missing from storage. FILE_REFERENCE_EMPTY Media / Files — An empty file reference was specified. FILE_REFERENCE_EXPIRED Media / Files — File reference expired, it must be refetched. FILE_REFERENCE_INVALID Media / Files — The specified file reference is invalid. FILE_TITLE_EMPTY Media / Files — An empty file title was specified. FILE_TOKEN_INVALID Media / Files — The specified file token is invalid. FILTER_ID_INVALID Folders / Filters — The specified filter ID is invalid. FILTER_INCLUDE_EMPTY Folders / Filters — The include_peers vector of the filter is empty. FILTER_NOT_SUPPORTED Folders / Filters — The specified filter cannot be used in this context. FILTER_TITLE_EMPTY Folders / Filters — The title field of the filter is empty. FIRSTNAME_INVALID Other — The first name is invalid. FOLDER_ID_EMPTY Folders / Filters — An empty folder ID was specified. FOLDER_ID_INVALID Folders / Filters — Invalid folder ID. FORUM_ENABLED Other — You can't execute the specified action because the group is a forum; disable forum functionality to continue. FROM_MESSAGE_BOT_DISABLED Other — Bots can't use fromMessage min constructors. FROM_PEER_INVALID Other — The specified from_id is invalid. FROZEN_METHOD_INVALID Other — You tried to use a method that is not available for frozen accounts. FROZEN_PARTICIPANT_MISSING Other — Your account is frozen and can't access the chat. GAME_BOT_INVALID Other — Bots can't send another bot's game. GEO_POINT_INVALID Other — Invalid geoposition provided. GIFT_SLUG_EXPIRED Other — The specified gift slug has expired. GIFT_SLUG_INVALID Other — The specified slug is invalid. GIF_CONTENT_TYPE_INVALID Media / Files — GIF content-type invalid. GIF_ID_INVALID Media / Files — The provided GIF ID is invalid. GRAPH_EXPIRED_RELOAD Other — This graph has expired, please obtain a new graph token. GRAPH_INVALID_RELOAD Other — Invalid graph token provided, please reload the stats and provide the updated token. GRAPH_OUTDATED_RELOAD Other — The graph is outdated, please get a new async token. GROUPCALL_ADD_PARTICIPANTS_FAILED Calls / Voice / Video — Failed to add participants to the group call. GROUPCALL_ALREADY_DISCARDED Calls / Voice / Video — The group call was already discarded. GROUPCALL_ALREADY_STARTED Calls / Voice / Video — The groupcall has already started, you can join directly. GROUPCALL_INVALID Calls / Voice / Video — The specified group call is invalid. GROUPCALL_JOIN_MISSING Calls / Voice / Video — You haven't joined this group call. GROUPCALL_NOT_MODIFIED Calls / Voice / Video — Group call settings weren't modified. GROUPCALL_SSRC_DUPLICATE_MUCH Calls / Voice / Video — The app needs to retry joining the group call with a new SSRC value. GROUPED_MEDIA_INVALID Other — Invalid grouped media. GROUP_CALL_INVALID Calls / Voice / Video — Group call invalid. HASH_INVALID Other — The provided hash is invalid. HIDE_REQUESTER_MISSING Other — The join request was missing or was already handled. HISTORY_GET_FAILED Other — Fetching of history failed. IMAGE_PROCESS_FAILED Media / Files — Failure while processing image. IMPORT_FILE_INVALID Other — The specified chat export file is invalid. IMPORT_FORMAT_UNRECOGNIZED Other — The specified chat export file was exported from an unsupported chat app. IMPORT_ID_INVALID Other — The specified import ID is invalid. IMPORT_TOKEN_INVALID Other — The specified token is invalid. INLINE_BOT_REQUIRED Bots & Inline — Only the inline bot can edit message. INLINE_RESULT_EXPIRED Bots & Inline — The inline query expired. INPUT_CHATLIST_INVALID Other — The specified folder is invalid. INPUT_CONSTRUCTOR_INVALID Other — The provided constructor is invalid. INPUT_FETCH_ERROR Other — An error occurred while deserializing TL parameters. INPUT_FETCH_ERROR_X Other · PARAM — An error occurred while deserializing TL parameters: %v. INPUT_FETCH_FAIL Other — Failed deserializing TL payload. INPUT_FILTER_INVALID Other — The specified filter is invalid. INPUT_LAYER_INVALID Other — The provided layer is invalid. INPUT_METHOD_INVALID Other — The specified method is invalid. INPUT_REQUEST_TOO_LONG Other — The input request was too long. INPUT_TEXT_EMPTY Other — The specified text is empty. INPUT_TEXT_TOO_LONG Other — The specified text is too long. INPUT_USER_DEACTIVATED Users & Peers — The specified user was deleted. INTERDC_X_CALL_ERROR Server / Internal · PARAM — An error occurred while communicating with DC %v. INTERDC_X_CALL_RICH_ERROR Server / Internal · PARAM — A rich error occurred while communicating with DC %v. INVITES_TOO_MUCH Flood / Rate limits — The maximum number of per-folder invites was reached. INVITE_FORBIDDEN_WITH_JOINAS Invites — You cannot invite users while anonymously joined as a channel. INVITE_HASH_EMPTY Invites — The invite hash is empty. INVITE_HASH_EXPIRED Invites — The invite link has expired. INVITE_HASH_INVALID Invites — The invite hash is invalid. INVITE_REQUEST_SENT Invites — You have successfully requested to join this chat or channel. INVITE_REVOKED_MISSING Invites — The specified invite link was already revoked or is invalid. INVITE_SLUG_EMPTY Invites — The specified invite slug is empty. INVITE_SLUG_EXPIRED Invites — The specified chat folder link has expired. INVOICE_PAYLOAD_INVALID Payments / Stars — The specified invoice payload is invalid. JOIN_AS_PEER_INVALID Other — The specified peer cannot be used to join a group call. LANG_CODE_INVALID Other — The specified language code is invalid. LANG_CODE_NOT_SUPPORTED Other — The specified language code is not supported. LANG_PACK_INVALID Other — The provided language pack is invalid. LASTNAME_INVALID Other — The last name is invalid. LIMIT_INVALID Other — The provided limit is invalid. LINK_NOT_MODIFIED Other — Discussion link not modified. LOCATION_INVALID Other — The provided location is invalid. MAX_DATE_INVALID Other — The specified maximum date is invalid. MAX_ID_INVALID Other — The provided max ID is invalid. MAX_QTS_INVALID Other — The specified max_qts is invalid. MD5_CHECKSUM_INVALID Other — The MD5 checksums do not match. MEDIA_CAPTION_TOO_LONG Media / Files — The caption is too long. MEDIA_EMPTY Media / Files — The provided media object is invalid. MEDIA_FILE_INVALID Media / Files — The specified media file is invalid. MEDIA_GROUPED_INVALID Media / Files — You tried to send media of different types in an album. MEDIA_INVALID Media / Files — Media invalid. MEDIA_NEW_INVALID Media / Files — The new media is invalid. MEDIA_PREV_INVALID Media / Files — Previous media invalid. MEDIA_TTL_INVALID Media / Files — The specified media TTL is invalid. MEDIA_TYPE_INVALID Media / Files — The specified media type cannot be used in stories. MEDIA_VIDEO_STORY_MISSING Media / Files — A non-story video cannot be republished as a story. MEGAGROUP_GEO_REQUIRED Channels & Chats — This method can only be invoked on a geogroup. MEGAGROUP_ID_INVALID Channels & Chats — Invalid supergroup ID. MEGAGROUP_PREHISTORY_HIDDEN Channels & Chats — Group with hidden history for new members can't be set as discussion groups. MEGAGROUP_REQUIRED Channels & Chats — You can only use this method on a supergroup. MEMBER_NO_LOCATION Other — An internal failure occurred while fetching user info (couldn't find location). MEMBER_OCCUPY_PRIMARY_LOC_FAILED Other — Occupation of primary member location failed. MESSAGE_AUTHOR_REQUIRED Messages — Message author required. MESSAGE_EDIT_TIME_EXPIRED Messages — You can't edit this message anymore, too much time has passed since its creation. MESSAGE_EMPTY Messages — The provided message is empty. MESSAGE_IDS_EMPTY Messages — No message ids were provided. MESSAGE_ID_INVALID Messages — The provided message id is invalid. MESSAGE_NOT_MODIFIED Messages — The provided message data is identical to the previous message data, the message wasn't modified. MESSAGE_POLL_CLOSED Messages — Poll closed. MESSAGE_TOO_LONG Messages — The provided message is too long. METHOD_INVALID Other — The specified method is invalid. MIN_DATE_INVALID Other — The specified minimum date is invalid. MSGID_DECREASE_RETRY Other — The request should be retried with a lower message ID. MSG_ID_INVALID Messages — Invalid message ID provided. MSG_TOO_OLD Messages — Time has passed since the message was sent, read receipts were deleted. MSG_WAIT_FAILED Messages — A waiting call returned an error. MT_SEND_QUEUE_TOO_LONG Other — The message was not sent because the send queue is too long. MULTI_MEDIA_TOO_LONG Other — Too many media files for album. NEED_CHAT_INVALID Other — The provided chat is invalid. NEED_MEMBER_INVALID Other — The provided member is invalid or does not exist. NEW_SALT_INVALID Other — The new salt is invalid. NEW_SETTINGS_EMPTY Other — No password is set on the current account, and no new password was specified in new_settings. NEW_SETTINGS_INVALID Other — The new password settings are invalid. NEXT_OFFSET_INVALID Other — The specified offset is longer than 64 bytes. NOT_ALLOWED Permissions / Forbidden — Action not allowed. OFFSET_INVALID Other — The provided offset is invalid. OFFSET_PEER_ID_INVALID Other — The provided offset peer is invalid. OPTIONS_TOO_MUCH Flood / Rate limits — Too many options provided. OPTION_INVALID Other — Invalid option selected. ORDER_INVALID Other — The specified username order is invalid. PACK_SHORT_NAME_INVALID Other — Short pack name invalid. PACK_SHORT_NAME_OCCUPIED Other — A stickerpack with this name already exists. PACK_TITLE_INVALID Other — The stickerpack title is invalid. PARTICIPANTS_TOO_FEW Other — Not enough participants. PARTICIPANT_CALL_FAILED Other — Failure while making call. PARTICIPANT_ID_INVALID Other — The specified participant ID is invalid. PARTICIPANT_JOIN_MISSING Other — User must join the Video Chat before enabling presentation. PARTICIPANT_VERSION_OUTDATED Other — The other participant does not use an up to date telegram client with support for calls. PASSWORD_EMPTY Authentication — The provided password is empty. PASSWORD_HASH_INVALID Authentication — The provided password hash is invalid. PASSWORD_MISSING Authentication — You must enable 2FA in order to transfer ownership of a channel. PASSWORD_RECOVERY_EXPIRED Authentication — The recovery code has expired. PASSWORD_RECOVERY_NA Authentication — No email was set, can't recover password via email. PASSWORD_REQUIRED Authentication — A 2FA password must be configured to use Telegram Passport. PASSWORD_TOO_FRESH_X Authentication · PARAM — The password was modified less than 24 hours ago, try again in %v seconds. PAYMENT_PROVIDER_INVALID Payments / Stars — The specified payment provider is invalid. PAYMENT_UNSUPPORTED Payments / Stars — This payment method is not acceptable. PEERS_LIST_EMPTY Other — The specified list of peers is empty. PEER_FLOOD Users & Peers — Too many requests. PEER_HISTORY_EMPTY Users & Peers — You can't pin an empty chat with a user. PEER_ID_INVALID Users & Peers — The provided peer id is invalid. PEER_ID_NOT_SUPPORTED Users & Peers — The provided peer ID is not supported. PERSISTENT_TIMESTAMP_EMPTY Other — Persistent timestamp empty. PERSISTENT_TIMESTAMP_INVALID Other — Persistent timestamp invalid. PERSISTENT_TIMESTAMP_OUTDATED Other — Channel internal replication issues, try again later. PHONE_CODE_EMPTY Authentication — phone_code is missing. PHONE_CODE_EXPIRED Authentication — The phone code you provided has expired. PHONE_CODE_HASH_EMPTY Authentication — phone_code_hash is missing. PHONE_CODE_INVALID Authentication — The provided phone code is invalid. PHONE_HASH_EXPIRED Other — An invalid or expired phone_code_hash was provided. PHONE_NOT_OCCUPIED Other — No user is associated to the specified phone number. PHONE_NUMBER_FLOOD Authentication — You asked for the code too many times. PHONE_NUMBER_INVALID Authentication — The phone number is invalid. PHONE_NUMBER_OCCUPIED Authentication — The phone number is already in use. PHONE_NUMBER_UNOCCUPIED Authentication — The phone number is not yet being used. PHONE_PASSWORD_FLOOD Other — You have tried logging in too many times. PHONE_PASSWORD_PROTECTED Other — This phone is password protected. PHOTO_CONTENT_TYPE_INVALID Media / Files — Photo mime-type invalid. PHOTO_CONTENT_URL_EMPTY Media / Files — Photo URL invalid. PHOTO_CROP_FILE_MISSING Media / Files — Photo crop file missing. PHOTO_CROP_SIZE_SMALL Media / Files — Photo is too small. PHOTO_EXT_INVALID Media / Files — The extension of the photo is invalid. PHOTO_FILE_MISSING Media / Files — Profile photo file missing. PHOTO_ID_INVALID Media / Files — Photo ID invalid. PHOTO_INVALID Media / Files — Photo invalid. PHOTO_INVALID_DIMENSIONS Media / Files — The photo dimensions are invalid. PHOTO_SAVE_FILE_INVALID Media / Files — Internal issues, try again later. PHOTO_THUMB_URL_EMPTY Media / Files — Photo thumbnail URL is empty. PINNED_DIALOGS_TOO_MUCH Flood / Rate limits — Too many pinned dialogs. POLL_ANSWERS_INVALID Polls & Quizzes — Invalid poll answers were provided. POLL_ANSWER_INVALID Polls & Quizzes — One of the poll answers is not acceptable. POLL_OPTION_DUPLICATE Polls & Quizzes — Duplicate poll options provided. POLL_OPTION_INVALID Polls & Quizzes — Invalid poll option provided. POLL_QUESTION_INVALID Polls & Quizzes — One of the poll questions is not acceptable. POLL_UNSUPPORTED Polls & Quizzes — This layer does not support polls in the issued method. POLL_VOTE_REQUIRED Polls & Quizzes — Cast a vote in the poll before calling this method. PREMIUM_ACCOUNT_REQUIRED Payments / Stars — A premium account is required to execute this action. PREMIUM_CURRENTLY_UNAVAILABLE Payments / Stars — Premium is currently unavailable. PREMIUM_SUB_ACTIVE_UNTIL_X Payments / Stars — You already have a premium subscription active until unixtime %v. PREVIOUS_CHAT_IMPORT_ACTIVE_WAIT_XMIN Other · PARAM — Import for this chat is already in progress, wait %v minutes before starting a new one. PTS_CHANGE_EMPTY Other — No PTS change. PUBLIC_CHANNEL_MISSING Other — You can only export group call invite links for public chats or channels. PUBLIC_KEY_REQUIRED Other — A public key is required. QUERY_ID_EMPTY Bots & Inline — The query ID is empty. QUERY_ID_INVALID Bots & Inline — The query ID is invalid. QUERY_TOO_SHORT Other — The query string is too short. QUIZ_ANSWER_MISSING Polls & Quizzes — You can forward a quiz while hiding the original author only after choosing an option in the quiz. QUIZ_CORRECT_ANSWERS_EMPTY Polls & Quizzes — No correct quiz answer was specified. QUIZ_CORRECT_ANSWERS_TOO_MUCH Flood / Rate limits — You specified too many correct answers in a quiz, quizzes can only have one right answer! QUIZ_CORRECT_ANSWER_INVALID Polls & Quizzes — An invalid value was provided to the correct_answers field. QUIZ_MULTIPLE_INVALID Polls & Quizzes — Quizzes can't have the multiple_choice flag set! RANDOM_ID_DUPLICATE Other — You provided a random ID that was already used. RANDOM_ID_EMPTY Other — Random ID empty. RANDOM_ID_INVALID Other — A provided random ID is invalid. RANDOM_LENGTH_INVALID Other — Random length invalid. RANGES_INVALID Other — Invalid range provided. REACTIONS_TOO_MANY Other — The message already has too many reaction emojis, you can't react with a new emoji. REACTION_EMPTY Messages — Empty reaction provided. REACTION_INVALID Messages — The specified reaction is invalid. REFLECTOR_NOT_AVAILABLE Other — Invalid call reflector server. REG_ID_GENERATE_FAILED Other — Failure while generating registration ID. REPLY_MARKUP_BUY_EMPTY Messages — Reply markup for buy button empty. REPLY_MARKUP_GAME_EMPTY Messages — The provided reply markup for the game is empty. REPLY_MARKUP_INVALID Messages — The provided reply markup is invalid. REPLY_MARKUP_TOO_LONG Messages — The specified reply_markup is too long. REPLY_MESSAGE_ID_INVALID Messages — The specified reply-to message ID is invalid. REPLY_TO_INVALID Messages — The specified reply_to field is invalid. REPLY_TO_USER_INVALID Messages — The replied-to user is invalid. RESET_REQUEST_MISSING Other — No password reset is in progress. RESULTS_TOO_MUCH Flood / Rate limits — Too many results were provided. RESULT_ID_DUPLICATE Other — You provided a duplicate result ID. RESULT_ID_EMPTY Other — Result ID empty. RESULT_ID_INVALID Other — One of the specified result IDs is invalid. RESULT_TYPE_INVALID Other — Result type invalid. REVOTE_NOT_ALLOWED Permissions / Forbidden — You cannot change your vote. RIGHTS_NOT_MODIFIED Other — The new admin rights are equal to the old rights, no change was made. RPC_CALL_FAIL Other — Telegram is having internal issues, please try again later. RPC_MCGET_FAIL Other — Telegram is having internal issues, please try again later. RSA_DECRYPT_FAILED Other — Internal RSA decryption failed. SCHEDULE_BOT_NOT_ALLOWED Permissions / Forbidden — Bots cannot schedule messages. SCHEDULE_DATE_INVALID Messages — Invalid schedule date provided. SCHEDULE_DATE_TOO_LATE Messages — You can't schedule a message this far in the future. SCHEDULE_STATUS_PRIVATE Messages — Can't schedule until user is online, if the user's last seen timestamp is hidden by their privacy settings. SCHEDULE_TOO_MUCH Flood / Rate limits — There are too many scheduled messages. SCORE_INVALID Other — The specified game score is invalid. SEARCH_QUERY_EMPTY Other — The search query is empty. SEARCH_WITH_LINK_NOT_SUPPORTED Other — You cannot provide a search query and an invite link at the same time. SECONDS_INVALID Other — Invalid duration provided. SEND_AS_PEER_INVALID Messages — You can't send messages as the specified peer. SEND_CODE_UNAVAILABLE Other — Returned when all available options for this type of number were already used. SEND_MEDIA_INVALID Other — The specified media is invalid. SEND_MESSAGE_MEDIA_INVALID Other — Invalid media provided. SEND_MESSAGE_TYPE_INVALID Other — The message type is invalid. SESSION_TOO_FRESH_X Authentication · PARAM — This session was created less than 24 hours ago, try again in %v seconds. SETTINGS_INVALID Other — Invalid settings were provided. SHA256_HASH_INVALID Other — The provided SHA256 hash is invalid. SHORTNAME_OCCUPY_FAILED Other — An error occurred when trying to register the short-name used for the sticker pack. Try a different name. SHORT_NAME_INVALID Other — The specified short name is invalid. SHORT_NAME_OCCUPIED Other — The specified short name is already in use. SIGN_IN_FAILED Other — Failure while signing in. SLOTS_EMPTY Other — The specified slot list is empty. SLOWMODE_MULTI_MSGS_DISABLED Flood / Rate limits — Slowmode is enabled, you cannot forward multiple messages to this group. SLOWMODE_WAIT_X Flood / Rate limits · PARAM — Slowmode is enabled in this chat: wait %v seconds before sending another message to this chat. SLUG_INVALID Other — The specified invoice slug is invalid. SMS_CODE_CREATE_FAILED Other — An error occurred while creating the SMS code. SRP_ID_INVALID Authentication — Invalid SRP ID provided. SRP_PASSWORD_CHANGED Authentication — Password has changed. START_PARAM_EMPTY Bots & Inline — The start parameter is empty. START_PARAM_INVALID Bots & Inline — Start parameter invalid. START_PARAM_TOO_LONG Bots & Inline — Start parameter is too long. STICKERPACK_STICKERS_TOO_MUCH Flood / Rate limits — There are too many stickers in this stickerpack, you can't add any more. STICKERSET_INVALID Media / Files — The provided sticker set is invalid. STICKERSET_OWNER_ANONYMOUS Media / Files — Provided stickerset can't be installed as group stickerset to prevent admin deanonymization. STICKERS_EMPTY Other — No sticker provided. STICKERS_TOO_MUCH Flood / Rate limits — There are too many stickers in this stickerpack, you can't add any more. STICKER_DOCUMENT_INVALID Media / Files — The specified sticker document is invalid. STICKER_EMOJI_INVALID Media / Files — Sticker emoji invalid. STICKER_FILE_INVALID Media / Files — Sticker file invalid. STICKER_GIF_DIMENSIONS Media / Files — The specified video sticker has invalid dimensions. STICKER_ID_INVALID Media / Files — The provided sticker ID is invalid. STICKER_INVALID Media / Files — The provided sticker is invalid. STICKER_MIME_INVALID Media / Files — The specified sticker MIME type is invalid. STICKER_PNG_DIMENSIONS Media / Files — Sticker png dimensions invalid. STICKER_PNG_NOPNG Media / Files — One of the specified stickers is not a valid PNG file. STICKER_TGS_NODOC Media / Files — You must send the animated sticker as a document. STICKER_TGS_NOTGS Media / Files — Invalid TGS sticker provided. STICKER_THUMB_PNG_NOPNG Media / Files — Incorrect stickerset thumb file provided, PNG / WEBP expected. STICKER_THUMB_TGS_NOTGS Media / Files — Incorrect stickerset TGS thumb file provided. STICKER_VIDEO_BIG Media / Files — The specified video sticker is too big. STICKER_VIDEO_NODOC Media / Files — You must send the video sticker as a document. STICKER_VIDEO_NOWEBM Media / Files — The specified video sticker is not in webm format. STORAGE_CHECK_FAILED Other — Server storage check failed. STORE_INVALID_SCALAR_TYPE Other — Invalid scalar type. STORIES_NEVER_CREATED Stories — This peer hasn't ever posted any stories. STORIES_TOO_MUCH Flood / Rate limits — You have hit the maximum active stories limit; you should buy a Premium subscription or wait for the oldest story to expire. STORY_ID_EMPTY Stories — You specified no story IDs. STORY_ID_INVALID Stories — The specified story ID is invalid. STORY_NOT_MODIFIED Stories — The new story information you passed is equal to the previous story information, thus it wasn't modified. STORY_PERIOD_INVALID Stories — The specified story period is invalid for this account. STORY_SEND_FLOOD_MONTHLY_X Stories — You've hit the monthly story limit; wait for the specified number of seconds before posting a new story. STORY_SEND_FLOOD_WEEKLY_X Stories — You've hit the weekly story limit; wait for the specified number of seconds before posting a new story. SWITCH_PM_TEXT_EMPTY Other — The switch_pm.text field was empty. TAKEOUT_INIT_DELAY_X Other · PARAM — Sorry, for security reasons, you will be able to begin downloading your data in %v seconds. TAKEOUT_INVALID Other — The specified takeout ID is invalid. TAKEOUT_REQUIRED Other — A takeout session needs to be initialized first. TASK_ALREADY_EXISTS Other — An email reset was already requested. TEMP_AUTH_KEY_ALREADY_BOUND Other — The passed temporary key is already bound to another perm_auth_key_id. TEMP_AUTH_KEY_EMPTY Other — No temporary auth key provided. THEME_FILE_INVALID Themes & Wallpapers — Invalid theme file provided. THEME_FORMAT_INVALID Themes & Wallpapers — Invalid theme format provided. THEME_INVALID Themes & Wallpapers — Invalid theme provided. THEME_MIME_INVALID Themes & Wallpapers — The theme's MIME type is invalid. THEME_TITLE_INVALID Themes & Wallpapers — The specified theme title is invalid. TITLE_INVALID Other — The specified stickerpack title is invalid. TMP_PASSWORD_DISABLED Other — The temporary password is disabled. TMP_PASSWORD_INVALID Other — Password auth needs to be regenerated. TOKEN_EMPTY Other — The specified token is empty. TOKEN_INVALID Authentication — The provided token is invalid. TOKEN_TYPE_INVALID Other — The specified token type is invalid. TOPICS_EMPTY Other — You specified no topic IDs. TOPIC_CLOSED Topics — This topic was closed, you can't send messages to it anymore. TOPIC_CLOSE_SEPARATELY Topics — The close flag cannot be provided together with any of the other flags. TOPIC_DELETED Topics — The specified topic was deleted. TOPIC_HIDE_SEPARATELY Topics — The hide flag cannot be provided together with any of the other flags. TOPIC_ID_INVALID Topics — The specified topic ID is invalid. TOPIC_NOT_MODIFIED Topics — The updated topic info is equal to the current topic info, nothing was changed. TOPIC_TITLE_EMPTY Topics — The specified topic title is empty. TO_LANG_INVALID Other — The specified destination language is invalid. TRANSCRIPTION_FAILED Other — Audio transcription failed. TTL_DAYS_INVALID Other — The provided TTL is invalid. TTL_MEDIA_INVALID Other — Invalid media Time To Live was provided. TTL_PERIOD_INVALID Other — The specified TTL period is invalid. TYPES_EMPTY Other — No top peer type was provided. TYPE_CONSTRUCTOR_INVALID Other — The type constructor is invalid. UNKNOWN_ERROR Other — The server has returned an unknown error. UNKNOWN_METHOD Other — The method you tried to call cannot be called on non-CDN DCs. UNTIL_DATE_INVALID Other — Invalid until date provided. UPDATE_APP_TO_LOGIN Other — This layer no longer supports logging in, please update your app. URL_INVALID Web previews — Invalid URL provided. USAGE_LIMIT_INVALID Other — The specified usage limit is invalid. USERNAMES_ACTIVE_TOO_MUCH Flood / Rate limits — The maximum number of active usernames was reached. USERNAME_INVALID Users & Peers — The provided username is not valid. USERNAME_NOT_MODIFIED Users & Peers — The username was not modified. USERNAME_NOT_OCCUPIED Users & Peers — The provided username is not occupied. USERNAME_OCCUPIED Users & Peers — The provided username is already occupied. USERNAME_PURCHASE_AVAILABLE Users & Peers — The specified username can be purchased. USERPIC_UPLOAD_REQUIRED Other — You must have a profile picture to publish your geolocation. USERS_TOO_FEW Other — Not enough users. USERS_TOO_MUCH Flood / Rate limits — The maximum number of users has been exceeded. USER_ADMIN_INVALID Users & Peers — You're not an admin. USER_ALREADY_INVITED Users & Peers — You have already invited this user. USER_ALREADY_PARTICIPANT Users & Peers — The user is already in the group. USER_BANNED_IN_CHANNEL Users & Peers — You're banned from sending messages in supergroups/channels. USER_BLOCKED Users & Peers — User blocked. USER_BOT Users & Peers — Bots can only be admins in channels. USER_BOT_INVALID Users & Peers — This method can only be invoked by bot accounts. USER_BOT_REQUIRED Users & Peers — This method can only be called by a bot. USER_CHANNELS_TOO_MUCH Flood / Rate limits — One of the users you tried to add is already in too many channels/supergroups. USER_CREATOR Users & Peers — You can't leave this channel, because you're its creator. USER_DELETED Users & Peers — You can't send this secret message because the other participant deleted their account. USER_ID_INVALID Users & Peers — The provided user ID is invalid. USER_INVALID Users & Peers — Invalid user provided. USER_IS_BLOCKED Users & Peers — You were blocked by this user. USER_IS_BOT Users & Peers — Bots can't send messages to other bots. USER_KICKED Users & Peers — This user was kicked from this supergroup/channel. USER_NOT_MUTUAL_CONTACT Users & Peers — The provided user is not a mutual contact. USER_PUBLIC_MISSING Users & Peers — Cannot generate a link to stories posted by a peer without a username. USER_VOLUME_INVALID Users & Peers — The specified user volume is invalid. VENUE_ID_INVALID Other — The specified venue ID is invalid. VIDEO_CONTENT_TYPE_INVALID Media / Files — The video's content type is invalid. VIDEO_FILE_INVALID Media / Files — The specified video file is invalid. VIDEO_TITLE_EMPTY Media / Files — The specified video title is empty. WALLPAPER_FILE_INVALID Media / Files — The specified wallpaper file is invalid. WALLPAPER_INVALID Media / Files — The specified wallpaper is invalid. WALLPAPER_MIME_INVALID Media / Files — The specified wallpaper MIME type is invalid. WC_CONVERT_URL_INVALID Other — WC convert URL invalid. WEBDOCUMENT_INVALID Web previews — Invalid webdocument URL provided. WEBDOCUMENT_MIME_INVALID Web previews — Invalid webdocument mime type provided. WEBDOCUMENT_SIZE_TOO_BIG Web previews — Webdocument is too big! WEBDOCUMENT_URL_INVALID Web previews — The specified webdocument URL is invalid. WEBPAGE_CURL_FAILED Web previews — Failure while fetching the webpage with cURL. WEBPAGE_MEDIA_EMPTY Web previews — Webpage media empty. WEBPAGE_URL_INVALID Web previews — The specified webpage url is invalid. WEBPUSH_AUTH_INVALID Other — The specified web push authentication secret is invalid. WEBPUSH_KEY_INVALID Other — The specified web push elliptic curve Diffie-Hellman public key is invalid. WEBPUSH_TOKEN_INVALID Other — The specified web push token is invalid. WORKER_BUSY_TOO_LONG_RETRY Server / Internal — Telegram workers are too busy to respond immediately. YOU_BLOCKED_USER Other — You blocked this user.

HTTP 401 — Unauthorized (17)

The session/auth key is no longer valid. The user must sign in again.

HTTP 403 — Forbidden (47)

The current user lacks permission to perform the action against this peer.

BROADCAST_FORBIDDEN Permissions / Forbidden — Channel poll voters and reactions cannot be fetched to prevent deanonymization. BROADCAST_PUBLIC_VOTERS_FORBIDDEN Permissions / Forbidden — You can't forward polls with public voters. BUTTON_USER_PRIVACY_RESTRICTED Permissions / Forbidden — The privacy setting of the user specified in the button do not allow creating such a button. CHANNELS_TOO_MUCH Flood / Rate limits — You have joined too many channels/supergroups. CHANNEL_BANNED Permissions / Forbidden — The channel is banned. CHANNEL_PRIVATE Channels & Chats — You haven't joined this channel/supergroup. CHANNEL_PUBLIC_GROUP_NA Channels & Chats — Channel/supergroup not available. CHAT_FORBIDDEN Permissions / Forbidden — You cannot write in this chat. CHAT_FORWARDS_RESTRICTED Permissions / Forbidden — You can't forward messages from a protected chat. CHAT_GUEST_SEND_FORBIDDEN Permissions / Forbidden — You must join the discussion group before commenting. CHAT_NOT_MODIFIED Channels & Chats — No changes were made to chat information because the new information is identical to the current information. CHAT_RESTRICTED Permissions / Forbidden — You can't send messages in this chat, you were restricted. CHAT_SEND_AUDIOS_FORBIDDEN Permissions / Forbidden — You can't send audio messages in this chat. CHAT_SEND_DOCS_FORBIDDEN Permissions / Forbidden — You can't send documents in this chat. CHAT_SEND_GAME_FORBIDDEN Permissions / Forbidden — You can't send a game to this chat. CHAT_SEND_GIFS_FORBIDDEN Permissions / Forbidden — You can't send gifs in this chat. CHAT_SEND_INLINE_FORBIDDEN Permissions / Forbidden — You can't send inline messages in this group. CHAT_SEND_MEDIA_FORBIDDEN Permissions / Forbidden — You can't send media in this chat. CHAT_SEND_PHOTOS_FORBIDDEN Permissions / Forbidden — You can't send photos in this chat. CHAT_SEND_PLAIN_FORBIDDEN Permissions / Forbidden — You can't send non-media (text) messages in this chat. CHAT_SEND_POLL_FORBIDDEN Permissions / Forbidden — You can't send polls in this chat. CHAT_SEND_STICKERS_FORBIDDEN Permissions / Forbidden — You can't send stickers in this chat. CHAT_SEND_VIDEOS_FORBIDDEN Permissions / Forbidden — You can't send videos in this chat. CHAT_SEND_VOICES_FORBIDDEN Permissions / Forbidden — You can't send voice recordings in this chat. CHAT_WRITE_FORBIDDEN Permissions / Forbidden — You can't write in this chat. EDIT_BOT_INVITE_FORBIDDEN Permissions / Forbidden — Normal users can't edit invites that were created by bots. EXPIRE_FORBIDDEN Permissions / Forbidden — The provided expire date is forbidden. FRESH_CHANGE_ADMINS_FORBIDDEN Permissions / Forbidden — You were just elected admin, you can't add or modify other admins yet. FRESH_CHANGE_PHONE_FORBIDDEN Permissions / Forbidden — You can't change phone number right after logging in, please wait at least 24 hours. FRESH_RESET_AUTHORISATION_FORBIDDEN Permissions / Forbidden — You can't logout other sessions if less than 24 hours have passed since you logged on the current session. GENERAL_MODIFY_ICON_FORBIDDEN Permissions / Forbidden — You can't modify the icon of the General topic. GROUPCALL_FORBIDDEN Permissions / Forbidden — The group call has already ended. MESSAGE_DELETE_FORBIDDEN Permissions / Forbidden — You can't delete one of the messages you tried to delete, most likely because it is a service message. PHONE_NUMBER_APP_SIGNUP_FORBIDDEN Authentication — You can't sign up using this app. PHONE_NUMBER_BANNED Authentication — The provided phone number is banned from telegram. PIN_RESTRICTED Permissions / Forbidden — You can't pin messages. PRIVACY_KEY_INVALID Permissions / Forbidden — The privacy key is invalid. PRIVACY_PREMIUM_REQUIRED Permissions / Forbidden — You need a Telegram Premium subscription to send a message to this user. PRIVACY_TOO_LONG Permissions / Forbidden — Too many privacy rules were specified, the current limit is 1000. PRIVACY_VALUE_INVALID Permissions / Forbidden — The specified privacy rule combination is invalid. RIGHT_FORBIDDEN Permissions / Forbidden — Your admin rights do not allow you to do this. SENSITIVE_CHANGE_FORBIDDEN Permissions / Forbidden — You can't change your sensitive content settings. USERPIC_PRIVACY_REQUIRED Permissions / Forbidden — You need to disable privacy settings for your profile picture in order to make your geolocation public. USER_NOT_PARTICIPANT Users & Peers — You're not a member of this supergroup/channel. USER_PRIVACY_RESTRICTED Permissions / Forbidden — The user's privacy settings do not allow you to do this. USER_RESTRICTED Permissions / Forbidden — You're spamreported, you can't create channels or chats. VOICE_MESSAGES_FORBIDDEN Permissions / Forbidden — This user's privacy settings forbid you from sending voice messages.

MTProto bad-message notifications (11)

Service-message error codes returned by the MTProto transport itself, before any RPC dispatch happens — usually the client's clock is wrong, the session salt expired, or a message id collided. Gogram surfaces these as *BadMsgError.

CodeDescription
16 msg_id too low (most likely, client time is wrong; it would be worthwhile to synchronize it using msg_id notifications and re-send the original message with the “correct” msg_id or wrap it in a container with a new msg_id if the original message had waited too long on the client to be transmitted)
17 msg_id too high (similar to the previous case, the client time has to be synchronized, and the message re-sent with the correct msg_id
18 incorrect two lower order msg_id bits (the server expects client message msg_id to be divisible by 4)
19 container msg_id is the same as msg_id of a previously received message (this must never happen)
20 message too old, and it cannot be verified whether the server has received a message with this msg_id or not
32 msg_seqno too low (the server has already received a message with a lower msg_id but with either a higher or an equal and odd seqno)
33 msg_seqno too high (similarly, there is a message with a higher msg_id but with either a lower or an equal and odd seqno)
34 an even msg_seqno expected (irrelevant message), but odd received
35 odd msg_seqno expected (relevant message), but even received
48 incorrect server salt (in this case, the bad_server_salt response is received with the correct salt, and the message is to be re-sent with it)
64 invalid container