Skip to main content
DELETE
Leave Group
Auth: TokenAccount or TokenInstanceRate-limit: Global (100/min) • Idempotent: yes (leaving a group you have already left returns 404)

Description

Makes the instance leave a group. The identifier goes in the query string (not in the body) since this is a DELETE.

Examples

Leave (by JID)

Removes the instance from the group 120363406289005073@g.us by passing the JID in the query string. This is the most direct format when you already have the JID at hand.
Leaves the group by passing the invite link (https://chat.whatsapp.com/ABC123XYZ) in identifier. The service extracts the code, resolves the JID, and performs the leave.

Success response

Confirms the leave by returning the groupJid of the group you left. Leaving a community (parent group) also unlinks the instance from the subgroups linked through that community. To return to the group, you will need a new invite.
200 OK

Path parameters

string
required
Instance name.

Headers

string
required
TokenAccount or TokenInstance.

Query

string
required
Group JID, invite code, or link.

Notes

  • Leaving a community (parent group) also unlinks the instance from the subgroups linked through that community.
  • To return to the group, you must obtain a new invite.

Errors

Envelope: