Method: messages.addChatUser

Back to methods index

Add a user to a normal chat (use channels->inviteToChannel for supergroups)


Name Type Description Required
chat_id Username, chat ID, Update, Message or InputPeer The chat where to invite users Optional
user_id Username, chat ID, Update, Message or InputUser The user to invite Optional
fwd_limit int Number of old messages the user will see Yes

Return type: Updates

Can bots use this method: NO

MadelineProto Example (now async for huge speed and parallelism!):

if (!file_exists('madeline.php')) {
    copy('', 'madeline.php');
define('MADELINE_BRANCH', '');
include 'madeline.php';

$MadelineProto = new \danog\MadelineProto\API('session.madeline');

$Updates = $MadelineProto->messages->addChatUser(['chat_id' => InputPeer, 'user_id' => InputUser, 'fwd_limit' => int, ]);

Or, if you’re into Lua:

Updates = messages.addChatUser({chat_id=InputPeer, user_id=InputUser, fwd_limit=int, })

Errors this method can return:

Error Description
CHAT_ADMIN_REQUIRED You must be an admin in this chat to do this
CHAT_ID_INVALID The provided chat id is invalid
INPUT_USER_DEACTIVATED The specified user was deleted
PEER_ID_INVALID The provided peer id is invalid
USER_ALREADY_PARTICIPANT The user is already in the group
USER_ID_INVALID The provided user ID is invalid
USERS_TOO_MUCH The maximum number of users has been exceeded (to create a chat, for example)
USER_NOT_MUTUAL_CONTACT The provided user is not a mutual contact
USER_PRIVACY_RESTRICTED The user’s privacy settings do not allow you to do this
This site uses cookies, as described in the cookie policy. By clicking on "Accept" you consent to the use of cookies.