WhatsApp Group Invite Links via API

Read, revoke and resolve group invite links.

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. Invite links are not part of the official API.

Read the full comparison

How it works

Read the code, rotate it on a schedule, resolve unknown codes before accepting, and join by code when you mean to.

  1. Read the current invite code

    The code is the tail of a chat.whatsapp.com link. Treat it as a credential rather than as a URL: anyone who holds it can join, so it belongs behind your own redirect rather than pasted into a public page you cannot update.

    API reference for this step
  2. Rotate it on a schedule

    Revoking generates a fresh code and invalidates every copy of the old link instantly. A nightly rotation means a link that leaks into a forum stops working within a day, without anyone having to notice that it leaked.

    API reference for this step
  3. Resolve a code before joining

    Given a code somebody sent you, read the group's name, size and owner before deciding. This is how a bot avoids joining a group it has no business being in.

    API reference for this step
  4. Accept the invitation

    Joining by code puts the linked number in the group as an ordinary member. Expect no admin rights, and expect the group's existing members to see the join as a system message.

    API reference for this step
curl --request GET \
  --url https://api.wapito.com/v1/groups/120363041234567890@g.us/invite \
  --header 'Authorization: Bearer wpt_YOUR_TOKEN'

Endpoints

Webhook events

  • groupsGroup joined, left or updatedonGroups()
  • groups.participantsGroup membership or role changedonGroupsParticipants()

What you can build with it

  • A self-service join page

    A sports club publishes one short link per team. Behind it, an automation reads the current invite code each time and redirects, so the club can rotate codes weekly without ever republishing the page or losing the printed posters.

  • Rotate after every intake

    A course provider revokes the invite link the day enrolment closes, so a link forwarded to a friend after the deadline simply stops working instead of quietly filling the group with people who never paid.

  • Vet a group before a bot joins

    A monitoring bot resolves any invite code it is given and checks the group's name and size against an allow-list before accepting. Codes that do not match are logged and ignored rather than joined and then left.

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. Invite links are not part of the official API.

With no group endpoints in the Cloud API there is no invite link to read or revoke. The link people paste in bios and on landing pages is generated in the app, and only a client that speaks the protocol can read or rotate it programmatically.

Paraphrase (not a verbatim quote), checked against the Cloud API reference index: no endpoint for reading, generating or revoking a group invite link appears in the reference.
Meta's WhatsApp documentation — checked

The official workaround

The nearest official thing is a click-to-chat link, which opens a one-to-one conversation with a business rather than joining a group. It solves a different problem: reaching you, not joining a shared thread.

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

  • Revoking is immediate and total: every printed poster, QR code and forwarded message carrying the old link stops working at once, so publish through a redirect you control rather than the raw link.
  • Reading or revoking the link requires the linked number to be an admin of that group, and the group settings can additionally restrict link management to admins only.

Tutorials by language

Automations and integrations

Frequently asked questions

How often should I rotate the invite link?

It depends on where it lives. A link on a private confirmation page can sit for months; a link on a public social profile is worth rotating weekly, because that is where scrapers find them. Rotating behind your own redirect costs nothing to your users, so err on the frequent side.

Can I see who joined through a particular link?

Not directly - WhatsApp reports that someone joined, not which link they used. If you need attribution, use a distinct group per source, or put your own redirect in front of each published link and correlate the click with the join event that follows it.

Does joining by link make my number an admin?

No. Anyone joining by link arrives as an ordinary member, including an automation. If the bot needs to moderate, an existing admin has to promote it after it joins, which is worth building into the onboarding rather than discovering when the first write fails.

Is there a limit on how many people can use one link?

The practical limit is the group's own member ceiling; once the group is full, the link stops admitting people. Plan for that if you publish a link widely, either by creating a second group in advance or by watching the member count and rotating to a fresh group before it fills.

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.