chatlists.joinChatlistInvite

Import a chat folder deep link », joining some or all the chats in the folder.

 Method schema is available as of layer 158. Switch »

Parameters

Name Type Description
slug string slug obtained from a chat folder deep link ».
peers Vector<InputPeer> List of new chats to join, fetched using chatlists.checkChatlistInvite and filtered as specified in the documentation ».

Result

Updates

Only users can use this method

Possible errors

Code Type Description
400 CHANNELS_TOO_MUCH You have joined too many channels/supergroups.
400 CHATLISTS_TOO_MUCH You have created too many folder links, hitting the chatlist_invites_limit_default/chatlist_invites_limit_premium limits ».
400 FILTER_INCLUDE_EMPTY The include_peers vector of the filter is empty.
400 INVITE_SLUG_EMPTY The specified invite slug is empty.
400 INVITE_SLUG_EXPIRED The specified chat folder link has expired.

Related pages

Deep links

Telegram clients must handle special tg:// and t.me deep links encountered in messages, link entities and in other apps by registering OS handlers.

chatlists.checkChatlistInvite

Obtain information about a chat folder deep link ».

Folders

Telegram allows placing chats into folders, based on their type, mute status, or other custom criteria, thanks to folder blacklists and whitelists.

Client configuration

The MTProto API has multiple configuration parameters that can be fetched with the appropriate methods.