--- title: Methods description: What do you want to do? image: 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](api_README.md) * [Logout](https://docs.madelineproto.xyz/logout.html) * [Login](https://docs.madelineproto.xyz/docs/LOGIN.html) * [Change 2FA password](https://docs.madelineproto.xyz/update2fa.html) * [Get all chats, broadcast a message to all chats](https://docs.madelineproto.xyz/docs/DIALOGS.html) * [Get the full participant list of a channel/group/supergroup](https://docs.madelineproto.xyz/getPwrChat.html) * [Get full info about a user/chat/supergroup/channel](https://docs.madelineproto.xyz/getFullInfo.html) * [Get info about a user/chat/supergroup/channel](https://docs.madelineproto.xyz/getInfo.html) * [Get info about the currently logged-in user](https://docs.madelineproto.xyz/getSelf.html) * [Upload or download files up to 1.5 GB](https://docs.madelineproto.xyz/docs/FILES.html) * [Make a phone call and play a song](https://docs.madelineproto.xyz/docs/CALLS.html) * [Create a secret chat bot](https://docs.madelineproto.xyz/docs/SECRET_CHATS.html) * 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](https://core.telegram.org/api/channel): channels.editBanned * Cancel the login verification code: auth.cancelCode * 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](https://core.telegram.org/api/channel): 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](https://core.telegram.org/api/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 »](https://core.telegram.org/api/account-deletion): account.confirmPhone * Confirms receipt of messages by a client, cancels PUSH-notification sending: messages.receivedMessages * Create a [supergroup/channel](https://core.telegram.org/api/channel): channels.createChannel * Create a stickerset, bots only: stickers.createStickerSet * Creates a new chat: messages.createChat * Delete a [channel/supergroup](https://core.telegram.org/api/channel): channels.deleteChannel * Delete a contact: contacts.deleteContact * Delete all messages sent by a certain user in a [supergroup](https://core.telegram.org/api/channel): channels.deleteUserHistory * Delete all temporary authorization keys **except for** the ones specified: auth.dropTempAuthKeys * Delete messages in a [channel/supergroup](https://core.telegram.org/api/channel): channels.deleteMessages * Delete saved contacts: contacts.resetSaved * Delete stored [Telegram Passport](https://core.telegram.org/passport) documents, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption): account.deleteSecureValue * Delete the history of a [supergroup](https://core.telegram.org/api/channel): 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](https://core.telegram.org/api/srp): 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 * 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](https://core.telegram.org/api/channel): 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](https://core.telegram.org/api/top-rating): 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 [channel/supergroup](https://core.telegram.org/api/channel) messages: channels.getMessages * Get [channels/supergroups/geogroups](https://core.telegram.org/api/channel) we're admin in. Usually called when the user exceeds the [limit](../constructors/config.md) for owned public [channels/supergroups/geogroups](https://core.telegram.org/api/channel), and the user is given the choice to remove one of his channels/supergroups/geogroups: channels.getAdminedPublicChannels * Get [instant view](https://instantview.telegram.org) page: messages.getWebPage * Get [passport](https://core.telegram.org/passport) configuration: help.getPassportConfig * Get a document by its SHA256 hash, mainly used for gifs: messages.getDocumentByHash * Get a list of [channels/supergroups](https://core.telegram.org/api/channel) 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](https://core.telegram.org/passport) documents, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption): account.getAllSecureValues * Get and increase the view counter of a message sent or forwarded from a [channel](https://core.telegram.org/api/channel): messages.getMessagesViews * Get changelog of current app: help.getAppChangelog * Get chats in common with a user: messages.getCommonChats * Get configuration for [CDN](https://core.telegram.org/cdn) file downloads: help.getCdnConfig * 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 highscores of a game sent using an inline bot: messages.getInlineGameHighScores * Get highscores of a game: messages.getGameHighScores * Get info about [channels/supergroups](https://core.telegram.org/api/channel): channels.getChannels * Get info about a [channel/supergroup](https://core.telegram.org/api/channel) participant: channels.getParticipant * Get info about a `t.me` link: help.getDeepLinkInfo * Get info about a stickerset: messages.getStickerSet * 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](https://core.telegram.org/api/channel): channels.exportMessageLink * Get live location history of a certain user: messages.getRecentLocations * Get localization pack strings: langpack.getLangPack * 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 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 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](https://core.telegram.org/passport) document, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption): 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](https://core.telegram.org/api/channel): channels.getAdminLog * Get the participants of a channel: channels.getParticipants * Get unread messages where we were mentioned: messages.getUnreadMentions * Get web [login widget](https://core.telegram.org/widgets/login) 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](../constructors/updateBotShippingQuery.md) 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 * 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](https://core.telegram.org/api/updates) (this is enabled by default for [file queries](https://core.telegram.org/api/files)): invokeWithoutUpdates * Invoke the specified query using the specified API [layer](https://core.telegram.org/api/invoking#layers): 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](https://core.telegram.org/api/channel): channels.leaveChannel * Log out an active [authorized session](https://core.telegram.org/api/auth) by its hash: account.resetAuthorization * Log out an active web [telegram login](https://core.telegram.org/widgets/login) session: account.resetWebAuthorization * Look for updates of telegram's terms of service: help.getTermsOfServiceUpdate * Make a user admin in a [legacy group](https://core.telegram.org/api/channel): messages.editChatAdmin * Manually mark dialog as unread: messages.markDialogUnread * Mark [channel/supergroup](https://core.telegram.org/api/channel) history as read: channels.readHistory * Mark [channel/supergroup](https://core.telegram.org/api/channel) 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](https://core.telegram.org/api/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](https://core.telegram.org/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): 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](../constructors/updateBotPrecheckoutQuery.md) update. : 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/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 * Register device to receive [PUSH notifications](https://core.telegram.org/api/push-updates): account.registerDevice * 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](../constructors/peerSettings.md) 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 recovery code of a [2FA password](https://core.telegram.org/api/srp), only for accounts with a [recovery email configured](https://core.telegram.org/api/srp#email-verification): auth.requestPasswordRecovery * 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](https://core.telegram.org/api/auth) for more info: auth.resendCode * Reset [rating](https://core.telegram.org/api/top-rating) of top peer: contacts.resetTopPeerRating * Reset all active web [telegram login](https://core.telegram.org/widgets/login) sessions: account.resetWebAuthorizations * Reset the [2FA password](https://core.telegram.org/api/srp) using the recovery code sent using [auth.requestPasswordRecovery](../methods/auth.requestPasswordRecovery.md): auth.recoverPassword * Resets all notification settings from users and groups: account.resetNotifySettings * Returns a Telegram Passport authorization form for sharing data with a service: account.getAuthorizationForm * 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 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 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 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](https://core.telegram.org/api/drafts) associated to a chat: messages.saveDraft * Save get all message [drafts](https://core.telegram.org/api/drafts): messages.getAllDrafts * 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](https://core.telegram.org/passport) document, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption): account.saveSecureValue * Send a media: messages.sendMedia * Send a result obtained using [messages.getInlineBotResults](../methods/messages.getInlineBotResults.md): 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 »](https://core.telegram.org/api/account-deletion): account.sendConfirmPhoneCode * Send phone call debug data to server: phone.saveCallDebug * Send the verification email code for telegram [passport](https://core.telegram.org/passport): account.sendVerifyEmailCode * Send the verification phone code for telegram [passport](https://core.telegram.org/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](../types/SendMessageAction.md) 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 service message to a secret chat: messages.sendEncryptedService * Sends a text message to a secret chat: messages.sendEncrypted * 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 * Start a conversation with a bot using a [deep linking parameter](https://core.telegram.org/bots#deep-linking): messages.startBot * Submit requested order information for validation: payments.validateRequestedInfo * Terminates all user's authorized sessions except for the current one: auth.resetAuthorizations * Turn a [legacy group into a supergroup](https://core.telegram.org/api/channel): 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](https://core.telegram.org/passport): account.verifyPhone * Verify an email address for telegram [passport](https://core.telegram.org/passport): account.verifyEmail * When client-side passcode lock feature is enabled, will not show message texts in incoming [PUSH notifications](https://core.telegram.org/api/push-updates): account.updateDeviceLocked * You cannot use this method directly, instead modify the PFS and default_temp_auth_key_expires_in settings, see https://docs.madelineproto.xyz/docs/SETTINGS.html for more info: auth.bindTempAuthKey * You cannot use this method directly, instead use $MadelineProto->getDhConfig();: messages.getDhConfig * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats: messages.acceptEncryption * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats: messages.discardEncryption * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats: messages.requestEncryption * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates: updates.getChannelDifference * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates: updates.getDifference * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates: updates.getState * You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls: phone.acceptCall * You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls: phone.confirmCall * You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls: phone.discardCall * You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls: phone.requestCall * You cannot use this method directly, use $MadelineProto->exportAuthorization() instead, see https://docs.madelineproto.xyz/docs/LOGIN.html: auth.exportAuthorization * You cannot use this method directly, use $MadelineProto->importAuthorization($authorization) instead, see https://docs.madelineproto.xyz/docs/LOGIN.html: auth.importAuthorization * You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info): auth.importBotAuthorization * You cannot use this method directly, use the completePhoneLogin method instead (see https://docs.madelineproto.xyz for more info): auth.signIn * You cannot use this method directly, use the completeSignup method instead (see https://docs.madelineproto.xyz for more info): auth.signUp * You cannot use this method directly, use the complete_2fa_login method instead (see https://docs.madelineproto.xyz for more info): auth.checkPassword * You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info): channels.getFullChannel * You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info): messages.getFullChat * You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info): users.getFullUser * You cannot use this method directly, use the logout method instead (see https://docs.madelineproto.xyz for more info): auth.logOut * You cannot use this method directly, use the phoneLogin method instead (see https://docs.madelineproto.xyz for more info): auth.sendCode * You cannot use this method directly, use the resolveUsername, getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info): contacts.resolveUsername * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info: upload.getCdnFile * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info: upload.getCdnFileHashes * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info: upload.getFile * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info: upload.getFileHashes * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info: upload.reuploadCdnFile * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info: upload.saveBigFilePart * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info: upload.saveFilePart * You cannot use this method directly: messages.receivedQueue * You cannot use this method directly; use $MadelineProto->update_2fa($params), instead (see https://docs.madelineproto.xyz for more info): account.getPasswordSettings * You cannot use this method directly; use $MadelineProto->update_2fa($params), instead (see https://docs.madelineproto.xyz for more info): account.updatePasswordSettings