MadelineProtoDocs/old_docs/API_docs_v27/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

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

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

• 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

• 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

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

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

• Check if this phone number is registered on telegram: auth.checkPhone

• 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 geochat: geochats.createGeoChat

• Creates a new chat.: messages.createChat

• Delete a contact: contacts.deleteContact

• 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

• Edit geochat photo: geochats.editChatPhoto

• Edit geochat title: geochats.editChatTitle

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

• Export contact as card: contacts.exportCard

• Forward message: messages.forwardMessage

• Forwards messages by their IDs.: messages.forwardMessages

• Get all installed stickers: messages.getAllStickers

• Get days to live of account: account.getAccountTTL

• Get full info about a geochat: geochats.getFullChat

• Get geochat history: geochats.getHistory

• Get logged-in sessions: account.getAuthorizations

• Get nearby geochats: geochats.getLocated

• Get new updates.: updates.getDifference

• 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 recent geochats: geochats.getRecents

• Get stickers by emoji: messages.getStickers

• Get suggested contacts: contacts.getSuggested

• 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

• 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

• Initialize connection: initConnection

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

• Invite friends to telegram!: auth.sendInvites

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

• 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 geochat: geochats.checkin

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

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

• Logs out the user.: auth.logOut

• Marks message history as read.: messages.readHistory

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

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

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

• Register device to receive PUSH notifications: account.registerDevice

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

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

• 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 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 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 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

• 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 messages in geocha: geochats.search

• Send SMS verification code: auth.sendSms

• Send a media: messages.sendMedia

• Send a message to all users in the chat list: messages.sendBroadcast

• Send media to geochat: geochats.sendMedia

• Send message to geochat: geochats.sendMessage

• Send the verification code for login: auth.sendCode

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

• Send typing notification to geochat: geochats.setTyping

• Send verification phone call: auth.sendCall

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

• 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

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

• 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

• Updates current user profile photo.: photos.uploadProfilePhoto

• Updates online user status.: account.updateStatus

• Updates user profile.: account.updateProfile

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

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

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