/api/groups/{groupJid}/participants/addAdds participants to a specific group. Requires admin privileges in the group.
Add Group Participants
Adds participants to a specific WhatsApp group. Requires admin privileges in the group.
Important: WhatsApp Restrictions
WhatsApp has introduced server-side restrictions that may prevent participants from being added directly to groups through automated API requests, even when the connected account is a group administrator.
Attempting this operation may result in:
- 403 Forbidden or 404 Not Found errors.
- Participants not being added to the group.
- The connected WhatsApp session being unexpectedly disconnected, potentially requiring reconnection.
These restrictions are enforced by WhatsApp and may affect automated group management operations. Successful execution cannot be guaranteed.
Recommended Alternative: Group Invite Links
Instead of adding participants directly, we recommend generating a group invite link and sending it to the intended participant through a WhatsApp message.
- Retrieve the group's invite link using the Get Group Invite Link API .
- Send the generated invite link to the specific WhatsApp user.
- The recipient can open the link and join the group.
This approach avoids the direct participant-add operation and reduces the risk of triggering WhatsApp's automated group management restrictions.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| groupJid | string | Yes | The JID (Jabber ID) of the group in the format [email protected]. |
| participants | array | Yes | Array of participant JIDs in E.164 format (international phone numbers) e.g., 1234567890. |
Code Examples
curl -X POST "https://www.wasenderapi.com/api/groups/{groupJid}/participants/add"
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{
"participants": [
"number1",
"number2"
]
}'Response Examples
{
"success": true,
"data": [
{
"status": 200,
"jid": "123456789",
"message": "added"
},
{
"status": 403,
"jid": "participant2",
"message": "not-authorized"
}
]
}