[{"data":1,"prerenderedAt":177},["ShallowReactive",2],{"pseo:features:group-admins":3,"highlight:pillar:group-admins":170},{"availability":4,"ban_risk":5,"ban_risk_note":6,"category":7,"cloud_api_status":11,"contrast":12,"endpoints":20,"faqs":46,"gotchas":59,"name":62,"published":63,"related":64,"search_terms":117,"seo":122,"slug":137,"step_summary":138,"steps":139,"summary":154,"tier":155,"updated":14,"url":132,"use_cases":156,"webhook_events":166},"ga","low","Promoting and demoting admins inside groups the linked number already administers is ordinary behaviour and carries little risk on its own. The risk lives in what people do with the rights afterwards: an automation that gains admin and immediately starts adding strangers will be treated exactly like one that did so without the role.",{"name":8,"slug":9,"url":10},"Groups","groups","\u002Fwhatsapp-api\u002Fgroups\u002F","forbidden",{"demand":13,"meta_checked":14,"meta_doc_url":15,"meta_quote":16,"official_workaround":17,"short_verdict":18,"verdict":19},"medium","2026-09-15","https:\u002F\u002Fdevelopers.facebook.com\u002Fdocs\u002Fwhatsapp\u002Fcloud-api\u002Freference","Paraphrase (not a verbatim quote), checked against the Cloud API reference index: the reference contains no group node, and therefore no participant roles to promote or demote.","None. Admin changes happen on a phone, by a person, in the group itself.","No. There are no group roles in the official API.","Group administration does not exist in Meta's Cloud API, so neither do admin roles. A business on the official platform cannot see who moderates a group, let alone change it, because the group itself is invisible to the platform.",[21,30,38],{"availability":4,"ban_risk":5,"curl":22,"method":25,"operationId":26,"path":27,"summary":28,"tag":9,"url":29},{"code":23,"lang":24},"curl --request GET \\\n  --url https:\u002F\u002Fapi.wapito.com\u002Fv1\u002Fgroups\u002F120363041234567890@g.us\u002Fparticipants \\\n  --header 'Authorization: Bearer wpt_YOUR_TOKEN'","bash","GET","listGroupParticipants","\u002Fgroups\u002F{id}\u002Fparticipants","List group participants","\u002Fdocs\u002Fapi\u002Fgroups\u002Flist-group-participants\u002F",{"availability":4,"ban_risk":5,"curl":31,"method":33,"operationId":34,"path":35,"summary":36,"tag":9,"url":37},{"code":32,"lang":24},"curl --request POST \\\n  --url https:\u002F\u002Fapi.wapito.com\u002Fv1\u002Fgroups\u002F120363041234567890@g.us\u002Fadmins \\\n  --header 'Authorization: Bearer wpt_YOUR_TOKEN' \\\n  --header 'Content-Type: application\u002Fjson' \\\n  --data '{\"participants\":[\"+15551234567\"]}'","POST","promoteGroupAdmins","\u002Fgroups\u002F{id}\u002Fadmins","Promote participants to admin","\u002Fdocs\u002Fapi\u002Fgroups\u002Fpromote-group-admins\u002F",{"availability":4,"ban_risk":5,"curl":39,"method":41,"operationId":42,"path":43,"summary":44,"tag":9,"url":45},{"code":40,"lang":24},"curl --request DELETE \\\n  --url 'https:\u002F\u002Fapi.wapito.com\u002Fv1\u002Fgroups\u002F120363041234567890@g.us\u002Fadmins\u002F+15551234567' \\\n  --header 'Authorization: Bearer wpt_YOUR_TOKEN'","DELETE","demoteGroupAdmin","\u002Fgroups\u002F{id}\u002Fadmins\u002F{pid}","Demote an admin to member","\u002Fdocs\u002Fapi\u002Fgroups\u002Fdemote-group-admin\u002F",[47,50,53,56],{"a":48,"q":49},"No. Roles apply to participants, so the person has to be a member first. Add or invite them, wait for the participants event that confirms they actually joined, and only then promote - a promotion aimed at a non-member fails rather than adding them.","Can I promote someone who is not in the group?",{"a":51,"q":52},"An admin can change the group's settings, its icon and its membership, and can promote or demote other admins. The superadmin is the creator: they have the same powers and additionally cannot be demoted or removed by anyone else, which makes the choice of creating number a long-lived decision.","What is the difference between admin and superadmin?",{"a":54,"q":55},"Yes. Role changes appear as system messages in the group, visible to everyone, and the affected person sees it in their chat. Treat promotion as a public act: it is not a quiet permission change, and demoting someone without warning is usually worth a message first.","Will people be notified that they were promoted?",{"a":57,"q":58},"Easily. Any other admin can demote the linked number from their phone, with no notification to your system, and the next write you attempt will be refused. Subscribe to the participants webhook and record the role so your system notices the demotion rather than discovering it mid-job.","Can an automation lose its own admin rights?",[60,61],"The group's creator holds a superadmin role and cannot be demoted by anyone. Filter that member out before a bulk demotion, or the call will report a failure you cannot fix.","The linked number must already be an admin to change anyone else's role, and it can lose that role at any time from another admin's phone, so re-check before each batch.","Group Admins",true,{"endpoints":65,"errors":72,"glossary":76,"hub":10,"integrations":86,"siblings":87,"tutorials":106,"vs_cloud_api":116},[66,68,70],{"title":67,"url":29},"GET \u002Fgroups\u002F{id}\u002Fparticipants",{"title":69,"url":37},"POST \u002Fgroups\u002F{id}\u002Fadmins",{"title":71,"url":45},"DELETE \u002Fgroups\u002F{id}\u002Fadmins\u002F{pid}",[73],{"title":74,"url":75},"forbidden (403)","\u002Fdocs\u002Ferrors\u002Fforbidden\u002F",[77,80,83],{"title":78,"url":79},"Group admin","\u002Fglossary\u002Fgroup-admin\u002F",{"title":81,"url":82},"JID","\u002Fglossary\u002Fjid\u002F",{"title":84,"url":85},"LID","\u002Fglossary\u002Flid\u002F",[],[88,91,94,97,100,103],{"title":89,"url":90},"Group Participants","\u002Fwhatsapp-api\u002Fgroup-participants\u002F",{"title":92,"url":93},"Group Settings","\u002Fwhatsapp-api\u002Fgroup-settings\u002F",{"title":95,"url":96},"Create Group","\u002Fwhatsapp-api\u002Fcreate-group\u002F",{"title":98,"url":99},"Group Join Requests","\u002Fwhatsapp-api\u002Fgroup-join-requests\u002F",{"title":101,"url":102},"Group Invite Link","\u002Fwhatsapp-api\u002Fgroup-invite-link\u002F",{"title":104,"url":105},"Group Info","\u002Fwhatsapp-api\u002Fgroup-info\u002F",[107,110,113],{"title":108,"url":109},"Python","\u002Fwhatsapp-api\u002Fgroup-admins\u002Fpython\u002F",{"title":111,"url":112},"Node.js","\u002Fwhatsapp-api\u002Fgroup-admins\u002Fnodejs\u002F",{"title":114,"url":115},"PHP","\u002Fwhatsapp-api\u002Fgroup-admins\u002Fphp\u002F","\u002Fvs-cloud-api\u002Fgroup-admins\u002F",[118,119,120,121],"whatsapp group admin api","promote admin whatsapp api","demote group admin api","whatsapp group moderation bot",{"breadcrumb":123,"canonical":133,"description":134,"h1":135,"lastmod":14,"title":136},[124,127,130,131],{"name":125,"url":126},"Home","\u002F",{"name":128,"url":129},"WhatsApp API","\u002Fwhatsapp-api\u002F",{"name":8,"url":10},{"name":62,"url":132},"\u002Fwhatsapp-api\u002Fgroup-admins\u002F","https:\u002F\u002Fwapito.com\u002Fwhatsapp-api\u002Fgroup-admins\u002F","Promote and demote admins in a WhatsApp group. No templates, no Meta approval, any number. 3 endpoints, code in Python, Node.js and PHP.","Promote and Demote WhatsApp Group Admins","WhatsApp Group Admin API | Wapito","group-admins","Read the current roles, promote from your own source of truth, demote what is stale, and follow role changes on the webhook.",[140,144,147,150],{"body":141,"operationId":26,"operation_url":29,"title":142,"webhook":143},"The participant list carries each member's role, including which one is the creator. Read it before you change anything: the creator cannot be demoted, so an automation that tries will fail on exactly that member.","See who holds a role today",null,{"body":145,"operationId":34,"operation_url":37,"title":146,"webhook":143},"Promotion is a single call that can carry several participants. Promote from your own source of truth - a team list, a rota, a role in your CRM - rather than from whoever happens to be talking in the group.","Promote the people who should moderate",{"body":148,"operationId":42,"operation_url":45,"title":149,"webhook":143},"Demotion is visible to the group, so do it as part of a clear process rather than silently. The linked number must itself be an admin, and it cannot demote the group's creator.","Demote anyone who no longer needs it",{"body":151,"operationId":143,"operation_url":143,"title":152,"webhook":153},"Promotions and demotions made by anyone, including other admins on their phones, arrive as events. This is how your system learns that the linked number was demoted before its next write fails.","Track role changes over the webhook","groups.participants","Promote and demote admins in a WhatsApp group.","t1b",[157,160,163],{"body":158,"title":159},"A community project promotes today's duty moderator each morning and demotes yesterday's, so the people with the power to remove members are exactly the people who are awake and responsible for the group at that hour.","Rotate moderation with the on-call rota",{"body":161,"title":162},"When an automation finishes with a group it created, it promotes the human owner to admin before leaving. Without that step the group is stranded with a superadmin that no longer participates and nobody who can change settings.","Hand over before the bot leaves",{"body":164,"title":165},"A franchise operator keeps a group per branch and promotes whoever holds the branch manager role in its own system. When the role changes hands in the CRM, the WhatsApp admin list follows within minutes instead of at the next audit.","Mirror your CRM's team roles",[167],{"event":153,"receiver":168,"summary":169},"onGroupsParticipants","Group membership or role changed",[171,173,175],{"label":67,"id":26,"lang":24,"code":23,"html":172},"\u003Cpre class=\"shiki shiki-themes github-light-default github-dark-default\" style=\"background-color:#ffffff;--shiki-dark-bg:#0d1117;color:#1f2328;--shiki-dark:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#953800;--shiki-dark:#FFA657\">curl\u003C\u002Fspan>\u003Cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\"> --request\u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\"> GET\u003C\u002Fspan>\u003Cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\"> \\\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">  --url\u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\"> https:\u002F\u002Fapi.wapito.com\u002Fv1\u002Fgroups\u002F120363041234567890@g.us\u002Fparticipants\u003C\u002Fspan>\u003Cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\"> \\\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">  --header\u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\"> 'Authorization: Bearer wpt_YOUR_TOKEN'\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",{"label":69,"id":34,"lang":24,"code":32,"html":174},"\u003Cpre class=\"shiki shiki-themes github-light-default github-dark-default\" style=\"background-color:#ffffff;--shiki-dark-bg:#0d1117;color:#1f2328;--shiki-dark:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#953800;--shiki-dark:#FFA657\">curl\u003C\u002Fspan>\u003Cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\"> --request\u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\"> POST\u003C\u002Fspan>\u003Cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\"> \\\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">  --url\u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\"> https:\u002F\u002Fapi.wapito.com\u002Fv1\u002Fgroups\u002F120363041234567890@g.us\u002Fadmins\u003C\u002Fspan>\u003Cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\"> \\\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">  --header\u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\"> 'Authorization: Bearer wpt_YOUR_TOKEN'\u003C\u002Fspan>\u003Cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\"> \\\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">  --header\u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\"> 'Content-Type: application\u002Fjson'\u003C\u002Fspan>\u003Cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\"> \\\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">  --data\u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\"> '{\"participants\":[\"+15551234567\"]}'\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",{"label":71,"id":42,"lang":24,"code":40,"html":176},"\u003Cpre class=\"shiki shiki-themes github-light-default github-dark-default\" style=\"background-color:#ffffff;--shiki-dark-bg:#0d1117;color:#1f2328;--shiki-dark:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#953800;--shiki-dark:#FFA657\">curl\u003C\u002Fspan>\u003Cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\"> --request\u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\"> DELETE\u003C\u002Fspan>\u003Cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\"> \\\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">  --url\u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\"> 'https:\u002F\u002Fapi.wapito.com\u002Fv1\u002Fgroups\u002F120363041234567890@g.us\u002Fadmins\u002F+15551234567'\u003C\u002Fspan>\u003Cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\"> \\\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">  --header\u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\"> 'Authorization: Bearer wpt_YOUR_TOKEN'\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",1790464898968]