MadelineProtoDocs/old_docs/API_docs_v89/methods

title	description	image
Methods	What do you want to do?	https://docs.madelineproto.xyz/favicons/android-chrome-256x256.png

What do you want to do?

Go back to API documentation index

Go to the old code-version method index

• Logout

• Login

• Change 2FA password

• Get all chats, broadcast a message to all chats

• Get the full participant list of a channel/group/supergroup

• Get full info about a user/chat/supergroup/channel

• Get info about a user/chat/supergroup/channel

• Get info about the currently logged-in user

• Upload or download files up to 1.5 GB

• Make a phone call and play a song

• Create a secret chat bot

• Accept incoming call: phone.acceptCall

• Accept the new terms of service: help.acceptTermsOfService

• Add GIF to saved gifs list: messages.saveGif

• Add a sticker to a stickerset, bots only. The sticker set must have been created by the bot.: stickers.addStickerToSet

• Add/remove sticker from recent stickers list: messages.saveRecentSticker

• Adds a user to a chat and sends a service message on it.: messages.addChatUser

• Adds the user to the blacklist.: contacts.block

• Allow or disallow any user to invite users to this channel/supergroup: channels.toggleInvites

• Answer an inline query, for bots only: messages.setInlineBotResults

• Answers a custom query; for bots only: bots.answerWebhookJSONQuery

• Associate a stickerset to the supergroup: channels.setStickers

• Ban/unban/kick a user in a supergroup/channel.: channels.editBanned

• Binds a temporary authorization key temp_auth_key_id to the permanent authorization key perm_auth_key_id. Each permanent key may only be bound to one temporary key at a time, binding a new temporary key overwrites the previous one.

For more information, see Perfect Forward Secrecy.: auth.bindTempAuthKey

• Cancel the code that was sent to verify an email to use as 2FA recovery method.: account.cancelPasswordEmail

• Cancel the login verification code: auth.cancelCode

• Cancels a request for creation and/or delete info on secret chat.: messages.discardEncryption

• Chanages chat name and sends a service message on it.: messages.editChatTitle

• Change privacy settings of current account: account.setPrivacy

• Change the phone number of the current account: account.changePhone

• Change the photo of a channel/supergroup: channels.editPhoto

• Change the username of a supergroup/channel: channels.updateUsername

• Changes chat photo and sends a service message on it: messages.editChatPhoto

• Changes the absolute position of a sticker in the set to which it belongs; for bots only. The sticker set must have been created by the bot: stickers.changeStickerPosition

• Changes username for the current user.: account.updateUsername

• Check if a username is free and can be assigned to a channel/supergroup: channels.checkUsername

• Check the validity of a chat invite link and get basic info about it: messages.checkChatInvite

• Clear all drafts.: messages.clearAllDrafts

• Clear recent stickers: messages.clearRecentStickers

• Clear saved payment information: payments.clearSavedInfo

• Confirm a phone number to cancel account deletion, for more info click here »: account.confirmPhone

• Confirms creation of a secret chat: messages.acceptEncryption

• Confirms receipt of messages by a client, cancels PUSH-notification sending.: messages.receivedMessages

• Confirms receipt of messages in a secret chat by client, cancels push notifications.: messages.receivedQueue

• Create a supergroup/channel.: channels.createChannel

• Create a stickerset, bots only.: stickers.createStickerSet

• Creates a new chat.: messages.createChat

• Delete a channel/supergroup: channels.deleteChannel

• Delete a contact: contacts.deleteContact

• Delete all messages sent by a certain user in a supergroup: channels.deleteUserHistory

• Delete all temporary authorization keys except for the ones specified: auth.dropTempAuthKeys

• Delete messages in a channel/supergroup: channels.deleteMessages

• Delete saved contacts: contacts.resetSaved

• Delete stored Telegram Passport documents, for more info see the passport docs »: account.deleteSecureValue

• Delete the history of a supergroup: channels.deleteHistory

• Delete the user's account from the telegram servers. Can be used, for example, to delete the account of a user that provided the login code, but forgot the 2FA password and no recovery method is configured.: account.deleteAccount

• Deletes a device by its token, stops sending PUSH-notifications to it.: account.unregisterDevice

• Deletes a user from a chat and sends a service message on it.: messages.deleteChatUser

• Deletes communication history.: messages.deleteHistory

• Deletes messages by their identifiers.: messages.deleteMessages

• Deletes profile photos.: photos.deletePhotos

• Deletes several contacts from the list.: contacts.deleteContacts

• Deletes the user from the blacklist.: contacts.unblock

• Download a CDN file.: upload.getCdnFile

• Edit an inline bot message: messages.editInlineBotMessage

• Edit message: messages.editMessage

• Edit the about text of a channel/supergroup: channels.editAbout

• Edit the name of a channel/supergroup: channels.editTitle

• Edits notification settings from a given user/group, from all users/all groups.: account.updateNotifySettings

• Enable all users are admins in normal groups (not supergroups): messages.toggleChatAdmins

• Enable/disable top peers: contacts.toggleTopPeers

• Enable/disable message signatures in channels: channels.toggleSignatures

• Export an invite link for a chat: messages.exportChatInvite

• Export contact as card: contacts.exportCard

• Export the invite link of a channel: channels.exportInvite

• Find out if a media message's caption can be edited: messages.getMessageEditData

• Finish account takeout session: account.finishTakeoutSession

• Forwards messages by their IDs.: messages.forwardMessages

• Get SHA256 hashes for verifying downloaded CDN files: upload.getCdnFileHashes

• Get SHA256 hashes for verifying downloaded files: upload.getFileHashes

• Get channel/supergroup messages: channels.getMessages

• Get channels/supergroups/geogroups we're admin in. Usually called when the user exceeds the limit for owned public channels/supergroups/geogroups, and the user is given the choice to remove one of his channels/supergroups/geogroups.: channels.getAdminedPublicChannels

• Get instant view page: messages.getWebPage

• Get passport configuration: help.getPassportConfig

• Get a document by its SHA256 hash, mainly used for gifs: messages.getDocumentByHash

• Get a list of channels/supergroups we left: channels.getLeftChannels

• Get a payment form: payments.getPaymentForm

• Get all archived stickers: messages.getArchivedStickers

• Get all chats, channels and supergroups: messages.getAllChats

• Get all contacts: contacts.getSaved

• Get all installed stickers: messages.getAllStickers

• Get all saved Telegram Passport documents, for more info see the passport docs »: account.getAllSecureValues

• Get and increase the view counter of a message sent or forwarded from a channel: messages.getMessagesViews

• Get changelog of current app: help.getAppChangelog

• Get chats in common with a user: messages.getCommonChats

• Get configuration for CDN file downloads.: help.getCdnConfig

• Get contact by telegram IDs: contacts.getContactIDs

• Get days to live of account: account.getAccountTTL

• Get dialog info of specified peers: messages.getPeerDialogs

• Get dialogs manually marked as unread: messages.getDialogUnreadMarks

• Get faved stickers: messages.getFavedStickers

• Get featured stickers: messages.getFeaturedStickers

• Get full info about a channel: channels.getFullChannel

• Get highscores of a game sent using an inline bot: messages.getInlineGameHighScores

• Get highscores of a game: messages.getGameHighScores

• Get info about channels/supergroups: channels.getChannels

• Get info about a channel/supergroup participant: channels.getParticipant

• Get info about a t.me link: help.getDeepLinkInfo

• Get info about a stickerset: messages.getStickerSet

• Get information about a language in a localization pack: langpack.getLanguage

• Get information about all languages in a localization pack: langpack.getLanguages

• Get installed mask stickers: messages.getMaskStickers

• Get link and embed info of a message in a channel/supergroup: channels.exportMessageLink

• Get live location history of a certain user: messages.getRecentLocations

• Get localization pack strings: langpack.getLangPack

• Get localized name of the telegram support user: help.getSupportName

• Get logged-in sessions: account.getAuthorizations

• Get message ranges for saving the user's chat history: messages.getSplitRanges

• Get most used peers: contacts.getTopPeers

• Get new updates.: updates.getDifference

• Get new strings in languagepack: langpack.getDifference

• Get payment receipt: payments.getPaymentReceipt

• Get peer settings: messages.getPeerSettings

• Get phone call configuration to be passed to libtgvoip's shared config: phone.getCallConfig

• Get pinned dialogs: messages.getPinnedDialogs

• Get preview of webpage: messages.getWebPagePreview

• Get privacy settings of current account: account.getPrivacy

• Get private info associated to the password info (recovery email, telegram passport info & so on): account.getPasswordSettings

• Get promotion info of the currently-used MTProxy: help.getProxyData

• Get recent stickers: messages.getRecentStickers

• Get recently used t.me links: help.getRecentMeUrls

• Get saved GIFs: messages.getSavedGifs

• Get saved Telegram Passport document, for more info see the passport docs »: account.getSecureValue

• Get saved payment information: payments.getSavedInfo

• Get stickers attached to a photo or video: messages.getAttachedStickers

• Get stickers by emoji: messages.getStickers

• Get strings from a language pack: langpack.getStrings

• Get temporary payment password: account.getTmpPassword

• Get the admin log of a channel/supergroup: channels.getAdminLog

• Get the participants of a channel: channels.getParticipants

• Get unread messages where we were mentioned: messages.getUnreadMentions

• Get web login widget authorizations: account.getWebAuthorizations

• Gets back found messages: messages.search

• Gets back the conversation history with one interlocutor / within a chat: messages.getHistory

• Gets current notification settings for a given user/group, from all users/all groups.: account.getNotifySettings

• Hide report spam popup: messages.hideReportSpam

• Hide/unhide message history for new channel/supergroup users: channels.togglePreHistoryHidden

• If you sent an invoice requesting a shipping address and the parameter is_flexible was specified, the bot will receive an updateBotShippingQuery update. Use this method to reply to shipping queries.: messages.setBotShippingResults

• Import a chat invite and join a private chat/supergroup/channel: messages.importChatInvite

• Import card as contact: contacts.importCard

• Imports contacts: saves a full list on the server, adds already registered contacts to the contact list, returns added contacts and their info.: contacts.importContacts

• Informs the server about the number of pending bot updates if they haven't been processed for a long time; for bots only: help.setBotUpdatesStatus

• Initialize connection: initConnection

• Install a stickerset: messages.installStickerSet

• Installs a previously uploaded photo as a profile photo.: photos.updateProfilePhoto

• Internal use: help.editUserInfo

• Internal use: help.getUserInfo

• Intialize account takeout session: account.initTakeoutSession

• Invite users to a channel/supergroup: channels.inviteToChannel

• Invoke a method within a takeout session: invokeWithTakeout

• Invoke a request without subscribing the used connection for updates (this is enabled by default for file queries).: invokeWithoutUpdates

• Invoke the specified query using the specified API layer: invokeWithLayer

• Invoke with the given message range: invokeWithMessagesRange

• Invokes a query after a successfull completion of previous queries: invokeAfterMsgs

• Invokes a query after successfull completion of one of the previous queries.: invokeAfterMsg

• Join a channel/supergroup: channels.joinChannel

• Leave a channel/supergroup: channels.leaveChannel

• Log out an active authorized session by its hash: account.resetAuthorization

• Log out an active web telegram login session: account.resetWebAuthorization

• Login as a bot: auth.importBotAuthorization

• Logs in a user using a key transmitted from his native data-centre.: auth.importAuthorization

• Logs out the user.: auth.logOut

• Look for updates of telegram's terms of service: help.getTermsOfServiceUpdate

• Make a user admin in a legacy group.: messages.editChatAdmin

• Manually mark dialog as unread: messages.markDialogUnread

• Mark channel/supergroup history as read: channels.readHistory

• Mark channel/supergroup message contents as read: channels.readMessageContents

• Mark a sticker as favorite: messages.faveSticker

• Mark mentions as read: messages.readMentions

• Mark new featured stickers as read: messages.readFeaturedStickers

• Marks message history as read.: messages.readHistory

• Marks message history within a secret chat as read.: messages.readEncryptedHistory

• Modify the admin rights of a user in a supergroup/channel.: channels.editAdmin

• Notifies the sender about the recipient having listened a voice message or watched a video.: messages.readMessageContents

• Notify the other user in a private chat that a screenshot of the chat was taken: messages.sendScreenshotNotification

• Notify the user that the sent passport data contains some errors The user will not be able to re-submit their Passport data to you until the errors are fixed (the contents of the field for which you returned the error must change).

Use this if the data submitted by the user doesn't satisfy the standards your service requires for any reason. For example, if a birthday date seems invalid, a submitted document is blurry, a scan shows evidence of tampering, etc. Supply some details in the error message to make sure the user knows how to correct the issues.: users.setSecureValueErrors

• Obtain configuration for two-factor authorization with password: account.getPassword

• Once the user has confirmed their payment and shipping details, the bot receives an updateBotPrecheckoutQuery update.
  Use this method to respond to such pre-checkout queries.
  Note: Telegram must receive an answer within 10 seconds after the pre-checkout query was sent.: messages.setBotPrecheckoutResults

• Optional: notify the server that the user is currently busy in a call: this will automatically refuse all incoming phone calls until the current phone call is ended.: phone.receivedCall

• Pin a message: messages.updatePinnedMessage

• Pin/unpin a dialog: messages.toggleDialogPin

• Press an inline callback button and get a callback answer from the bot: messages.getBotCallbackAnswer

• Query an inline bot: messages.getInlineBotResults

• Rate a call: phone.setCallRating

• Refuse or end running call: phone.discardCall

• Register device to receive PUSH notifications: account.registerDevice

• Registers a validated phone number in the system.: auth.signUp

• Remove a sticker from the set where it belongs, bots only. The sticker set must have been created by the bot.: stickers.removeStickerFromSet

• Reorder installed stickersets: messages.reorderStickerSets

• Reorder pinned dialogs: messages.reorderPinnedDialogs

• Report a message in a chat for violation of telegram's Terms of Service: messages.report

• Report a new incoming chat for spam, if the peer settings of the chat allow us to do that: messages.reportSpam

• Report a peer for violation of telegram's Terms of Service: account.reportPeer

• Report a secret chat for spam: messages.reportEncryptedSpam

• Reports some messages from a user in a supergroup as spam; requires administrator rights in the supergroup: channels.reportSpam

• Request a reupload of a certain file to a CDN DC.: upload.reuploadCdnFile

• Request recovery code of a 2FA password, only for accounts with a recovery email configured.: auth.requestPasswordRecovery

• Resend the code to verify an email to use as 2FA recovery method.: account.resendPasswordEmail

• Resend the login code via another medium, the phone code type is determined by the return value of the previous auth.sendCode/auth.resendCode: see login for more info.: auth.resendCode

• Reset rating of top peer: contacts.resetTopPeerRating

• Reset all active web telegram login sessions: account.resetWebAuthorizations

• Reset the 2FA password using the recovery code sent using auth.requestPasswordRecovery.: auth.recoverPassword

• Resets all notification settings from users and groups.: account.resetNotifySettings

• Resolve a @username to get peer info: contacts.resolveUsername

• Returns a Telegram Passport authorization form for sharing data with a service: account.getAuthorizationForm

• Returns a current state of updates.: updates.getState

• Returns a list of available wallpapers.: account.getWallPapers

• Returns basic user info according to their identifiers.: users.getUsers

• Returns chat basic info on their IDs.: messages.getChats

• Returns configuration parameters for Diffie-Hellman key generation. Can also return a random sequence of bytes of required length.: messages.getDhConfig

• Returns content of a whole file or its part.: upload.getFile

• Returns content of an HTTP file or a part, by proxying the request through telegram.: upload.getWebFile

• Returns current configuration, icluding data center configuration.: help.getConfig

• Returns data for copying authorization to another data-centre.: auth.exportAuthorization

• Returns extended user info by ID.: users.getFullUser

• Returns full chat info according to its ID.: messages.getFullChat

• Returns info on data centre nearest to the user.: help.getNearestDc

• Returns information on update availability for the current application.: help.getAppUpdate

• Returns text of a text message with an invitation.: help.getInviteText

• Returns the current user dialog list.: messages.getDialogs

• Returns the current user's contact list.: contacts.getContacts

• Returns the difference between the current state of updates of a certain channel and transmitted.: updates.getChannelDifference

• Returns the list of blocked users.: contacts.getBlocked

• Returns the list of contact statuses.: contacts.getStatuses

• Returns the list of messages by their IDs.: messages.getMessages

• Returns the list of user photos.: photos.getUserPhotos

• Returns the support user for the 'ask a question' feature.: help.getSupport

• Returns users found by username substring.: contacts.search

• Save a message draft associated to a chat.: messages.saveDraft

• Save get all message drafts.: messages.getAllDrafts

• Saves a part of a large file (over 10Mb in size) to be later passed to one of the methods.: upload.saveBigFilePart

• Saves a part of file for futher sending to one of the methods.: upload.saveFilePart

• Saves logs of application on the server.: help.saveAppLog

• Search for GIFs: messages.searchGifs

• Search for messages and peers globally: messages.searchGlobal

• Search for stickersets: messages.searchStickerSets

• Securely save Telegram Passport document, for more info see the passport docs »: account.saveSecureValue

• Send a media: messages.sendMedia

• Send a result obtained using messages.getInlineBotResults.: messages.sendInlineBotResult

• Send an album of media: messages.sendMultiMedia

• Send compiled payment form: payments.sendPaymentForm

• Send confirmation code to cancel account deletion, for more info click here »: account.sendConfirmPhoneCode

• Send phone call debug data to server: phone.saveCallDebug

• Send the verification code for login: auth.sendCode

• Send the verification email code for telegram passport.: account.sendVerifyEmailCode

• Send the verification phone code for telegram passport.: account.sendVerifyPhoneCode

• Send typing event by the current user to a secret chat.: messages.setEncryptedTyping

• Sends a Telegram Passport authorization form, effectively sharing data with the service: account.acceptAuthorization

• Sends a current user typing event (see SendMessageAction for all event types) to a conversation partner or group.: messages.setTyping

• Sends a custom request; for bots only: bots.sendCustomRequest

• Sends a message to a chat: messages.sendMessage

• Sends a message with a file attachment to a secret chat: messages.sendEncryptedFile

• Sends a request to start a secret chat to the user.: messages.requestEncryption

• Sends a service message to a secret chat.: messages.sendEncryptedService

• Sends a text message to a secret chat.: messages.sendEncrypted

• Set a new 2FA password: account.updatePasswordSettings

• Set account self-destruction period: account.setAccountTTL

• Set the callback answer to a user button press (bots only): messages.setBotCallbackAnswer

• Set the pinned message of a channel/supergroup: channels.updatePinnedMessage

• Signs in a user with a validated phone number.: auth.signIn

• Start a conversation with a bot using a deep linking parameter: messages.startBot

• Start a telegram phone call: phone.requestCall

• Submit requested order information for validation: payments.validateRequestedInfo

• Terminates all user's authorized sessions except for the current one.

After calling this method it is necessary to reregister the current device using the method account.registerDevice: auth.resetAuthorizations

• Try logging to an account protected by a 2FA password.: auth.checkPassword

• Turn a legacy group into a supergroup: messages.migrateChat

• Uninstall a stickerset: messages.uninstallStickerSet

• Updates current user profile photo.: photos.uploadProfilePhoto

• Updates online user status.: account.updateStatus

• Updates user profile.: account.updateProfile

• Upload a file and associate it to a chat (without actually sending it to the chat): messages.uploadMedia

• Upload encrypted file and associate it to a secret chat: messages.uploadEncryptedFile

• Use this method to set the score of the specified user in a game sent as a normal message (bots only).: messages.setGameScore

• Use this method to set the score of the specified user in a game sent as an inline message (bots only).: messages.setInlineGameScore

• Validates a username and checks availability.: account.checkUsername

• Verify a new phone number to associate to the current account: account.sendChangePhoneCode

• Verify a phone number for telegram passport.: account.verifyPhone

• Verify an email address for telegram passport.: account.verifyEmail

• Verify an email to use as 2FA recovery method.: account.confirmPasswordEmail

• When client-side passcode lock feature is enabled, will not show message texts in incoming PUSH notifications.: account.updateDeviceLocked

• Complete phone call E2E encryption key exchange »: phone.confirmCall