Skip to main content
POST
/
group
/
updateParticipants
Manage group participants
curl --request POST \
  --url https://api.wppfy.com/group/updateParticipants \
  --header 'Content-Type: application/json' \
  --header 'token: <api-key>' \
  --data '
{
  "groupjid": "120363308883996631@g.us",
  "action": "promote",
  "participants": [
    "5521987654321",
    "5511999887766"
  ]
}
'
{
  "groupUpdated": [
    {
      "JID": "<string>",
      "Error": 123
    }
  ],
  "group": {
    "JID": "jid8@g.us",
    "OwnerJID": "1232@s.whatsapp.net",
    "Name": "Grupo de Suporte",
    "NameSetAt": "2023-11-07T05:31:56Z",
    "NameSetBy": "<string>",
    "Topic": "<string>",
    "IsLocked": true,
    "IsAnnounce": true,
    "AnnounceVersionID": "<string>",
    "IsEphemeral": true,
    "DisappearingTimer": 1,
    "IsIncognito": true,
    "IsParent": true,
    "IsJoinApprovalRequired": true,
    "LinkedParentJID": "<string>",
    "IsDefaultSubGroup": true,
    "GroupCreated": "2023-11-07T05:31:56Z",
    "ParticipantVersionID": "<string>",
    "Participants": [
      "<unknown>"
    ],
    "MemberAddMode": "admin_add",
    "OwnerCanSendMessage": true,
    "OwnerIsAdmin": true,
    "DefaultSubGroupId": "<string>",
    "invite_link": "<string>",
    "request_participants": "<string>"
  }
}

Authorizations

token
string
header
required

Body

application/json
groupjid
string
required

Group JID (identifier)

Example:

"120363308883996631@g.us"

action
enum<string>
required

Action to be performed:

  • add: Add participants to the group
  • remove: Remove participants from the group
  • promote: Promote participants to administrators
  • demote: Remove administrator privileges
  • approve: Approve pending join requests
  • reject: Reject pending join requests
Available options:
add,
remove,
promote,
demote,
approve,
reject
Example:

"promote"

participants
string[]
required

List of phone numbers or JIDs of the participants. For phone numbers, use international format without '+' or spaces.

Example:
["5521987654321", "5511999887766"]

Response

Operation successful

groupUpdated
object[]

Operation status for each participant

group
object

Updated group information