Change WhatsApp Group Settings via API
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. The official API cannot configure a group.
Read the full comparisonHow it works
Read the settings, restrict posting when you are broadcasting, reopen on schedule, and keep an audit trail from the group webhook.
Read the current settings
The group object carries who may send messages, who may edit the subject and icon, and whether new members need approval. Read before you write so a scheduled job does not flip a setting an admin changed deliberately an hour ago.
API reference for this stepRestrict posting to admins
Announcement mode is a single field. It is the right default for any group you use to broadcast, because it removes the whole class of accidental replies to hundreds of people.
API reference for this stepOpen it again on a schedule
Flip the same field back when a discussion window opens. Running this from a scheduler is how a large group can hold a question hour without a moderator sitting on the mute button.
API reference for this stepRecord the change from the webhook
Settings changes arrive as group events, including ones made by other admins on their phones, so your audit trail reflects what actually happened rather than what your job intended.
curl --request PATCH \
--url https://api.wapito.com/v1/groups/120363041234567890@g.us/settings \
--header 'Authorization: Bearer wpt_YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--data '{"messages_admin_only":false,"membership_approval":true}'Endpoints
Webhook events
groupsGroup joined, left or updatedonGroups()
What you can build with it
- Announcement mode outside office hours
A clinic locks its patient group to admins-only each evening and reopens it in the morning, so overnight messages do not pile up unanswered and nobody receives a notification at three in the morning because someone replied to a reminder.
- Require approval during a public campaign
When a group link is promoted publicly, an automation turns on join approval for the duration, so a moderator reviews requests instead of the group filling with accounts nobody recognises. Approval is turned off again when the campaign ends.
- Freeze a group before an announcement
A results service locks its group a few minutes before publishing, posts the announcement, then reopens it. The announcement stays at the top of the thread long enough for everyone to see it before discussion starts.
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. The official API cannot configure a group.
Group settings are part of the group object, and the group object does not exist in Meta's Cloud API. There is no announcement mode to toggle and no approval setting to turn on, because there is no group for the platform to describe.
Paraphrase (not a verbatim quote), checked against the Cloud API reference index: no group settings object appears in the reference.
The official workaround
None. An admin opens the group on a phone and changes the setting by hand, which cannot be scheduled and cannot be driven by anything in your own systems.
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
- Settings changes are announced in the group as system messages, so a scheduler that flips a setting twice an hour produces visible noise for every member.
- The linked number needs admin rights, and a group already restricted to admins for edits will refuse changes from a member that was demoted since your last run.
Tutorials by language
Frequently asked questions
What settings can I change from the API?
The ones an admin sees on the phone: who may send messages, who may edit the group's subject, icon and description, and whether people joining by link need approval first. Read the group object to see the current values, because other admins can change them at any time.
Does announcement mode stop replies entirely?
It stops non-admins from posting in the group, which is what makes it suitable for broadcasts. People can still react to messages, and they can still message the linked number privately, so plan a path for the replies you do want rather than assuming nobody will try.
Can I make a group members-only invisible to search?
Groups are not searchable on WhatsApp in the first place - they are reachable only through an invite link or a direct add. The nearest control is to revoke the link and require approval, which together mean nobody joins without an admin acting.
Will members be notified when I change a setting?
Yes. Each change appears in the group as a system message naming the admin who made it, so an automation acting under the linked number will be visibly attributed. If the change is routine, that visibility is usually fine; if it is frequent, consider batching it.
Related
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.