Wapito

Promote and Demote WhatsApp Group Admins

Promote and demote admins in a WhatsApp group.

Groups are the part of WhatsApp the official Cloud API never reached: there is no endpoint to create one, administer it or read its members. Wapito drives a linked number instead, so a group is an ordinary REST call.

Can the official WhatsApp Cloud API do this?

No. There are no group roles in the official API.

Read the full comparison

How it works

Read the current roles, promote from your own source of truth, demote what is stale, and follow role changes on the webhook.

  1. See who holds a role today

    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.

    API reference for this step

  2. Promote the people who should moderate

    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.

    API reference for this step

  3. Demote anyone who no longer needs it

    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.

    API reference for this step

  4. Track role changes over the webhook

    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.

curl --request GET \
  --url https://api.wapito.com/v1/groups/120363041234567890@g.us/participants \
  --header 'Authorization: Bearer wpt_YOUR_TOKEN'

Endpoints

Webhook events

  • groups.participantsGroup membership or role changedonGroupsParticipants()

What you can build with it

  • Rotate moderation with the on-call rota

    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.

  • Hand over before the bot leaves

    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.

  • Mirror your CRM's team roles

    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.

What the official WhatsApp Cloud API does here

Meta's official WhatsApp Cloud API is built for business messaging: templates, customer-service windows and per-conversation pricing. A large part of what WhatsApp itself can do — groups, channels, status, presence, contact lookups — has no endpoint there at all, which is why so many teams end up looking past it. Everything below is checked against Meta's own published reference, with the link and the date we checked it.

Not possible on the Cloud API

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.

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.
Meta's WhatsApp documentation — checked

The official workaround

None. Admin changes happen on a phone, by a person, in the group itself.

Wapito is an independent product. It is not affiliated with, endorsed by, sponsored by or certified by WhatsApp or Meta Platforms, Inc. WhatsApp is a trademark of Meta Platforms, Inc.

Gotchas

  • 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.

Tutorials by language

Frequently asked questions

Can I promote someone who is not in the group?

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.

What is the difference between admin and superadmin?

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.

Will people be notified that they were promoted?

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.

Can an automation lose its own admin rights?

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.

Related

Related features

Errors you may hit

Glossary

Try it on your own number

Create a channel, link a WhatsApp number by QR or pairing code, and call the API in a couple of minutes. The Sandbox plan is free and needs no card.

Create a free channel Read the docs