Add Participants

Supported & Tested

Add participants to a WhatsApp group and pass through WhatsApp per-participant results.

POSThttps://api.waplix.io/api/v1/groups/participants-add
Authentication
Authorization: Bearer YOUR_API_KEY
Parameters Specification
instance_id
stringReq

Required Waplix instance id

group_id
stringReq

Required WhatsApp group id ending with @g.us

participants
arrayReq

Required array of phone numbers or JIDs

Usage Notes
A 409 status usually means WhatsApp did not add the participant, often because of invite/privacy limits or the user is already pending in another membership state.
Request Payload Example
Request
curl -X POST "https://api.waplix.io/api/v1/api/v1/groups/participants-add" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Success Response
Response · 200 OK
{
  "success": true,
  "data": {
    "instance_id": "39058",
    "group_id": "120363429508183753@g.us",
    "participants": [
      "923000935862@s.whatsapp.net"
    ],
    "action": "add",
    "results": [
      {
        "status": "409",
        "jid": "142120618831980@lid",
        "content": {
          "attrs": {
            "phone_number": "923000935862@s.whatsapp.net"
          }
        }
      }
    ]
  }
}
Was this page helpful?