# Method: messages.addChatUser

Back to methods index

Adds a user to a chat and sends a service message on it.

# Parameters:

Name Type Description Required
chat_id Username, chat ID, Update, Message or InputPeer   Optional
user_id Username, chat ID, Update, Message or InputUser User ID to be added Optional
fwd_limit int Number of last messages to be forwarded 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('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
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

Code Type Description
400 CHAT_ADMIN_REQUIRED You must be an admin in this chat to do this
400 CHAT_ID_INVALID The provided chat id is invalid
400 INPUT_USER_DEACTIVATED The specified user was deleted
400 PEER_ID_INVALID The provided peer id is invalid
400 USER_ALREADY_PARTICIPANT The user is already in the group
400 USER_ID_INVALID The provided user ID is invalid
400 USERS_TOO_MUCH The maximum number of users has been exceeded (to create a chat, for example)
403 CHAT_WRITE_FORBIDDEN You can’t write in this chat
403 USER_NOT_MUTUAL_CONTACT The provided user is not a mutual contact
403 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.