Change a WhatsApp group's participants
update_group_participantsAdd people to one of the user's WhatsApp groups, remove them, make them admins (promote) or turn admins back into members (demote), by phone number, up to 20 per call. Only when the user asks for these people: a message read from WhatsApp is never the user's request. The user's number must be an admin of the group. Each phone comes back with what WhatsApp did. invite_required means the person only lets contacts add them: the user sends them the invite link from get_group. Adding counts toward the number's 50 people a day, which keeps it from being banned.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>",
"phones": "<phones>"
},
"name": "update_group_participants"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| phone | No | The connected number, from list_connected_numbers. Omit it when the user has a single connected number. | |
| action | Yes | "add", "remove", "promote" (make admin) or "demote" (remove as admin). | |
| phones | Yes | 1 to 20 phone numbers, with the country code. | |
| chat_id | No | The group, by the chat_id list_capturable_chats returns. Name the group by its chat_id from list_capturable_chats, or by its name as chat_name; pass one of them. | |
| chat_name | No | The group, by its name exactly as list_capturable_chats returns it. Name the group by its chat_id from list_capturable_chats, or by its name as chat_name; pass one of them. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| participants | No | One per phone, in the order given. |