> For the complete documentation index, see [llms.txt](https://docs.360dialog.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.360dialog.com/docs/messaging-api/api-reference/groups.md).

# Groups

Endpoints for managing WhatsApp groups

## Get Active Groups

> Retrieve list of active groups for a business phone number with pagination support.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"Groups","description":"Endpoints for managing WhatsApp groups"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"groups.GetActiveGroupsResponse":{"description":"Response payload containing a paginated list of active groups","properties":{"data":{"$ref":"#/components/schemas/groups.GetActiveGroupsData","description":"Response data object containing groups"},"paging":{"$ref":"#/components/schemas/groups.GroupPaging","description":"Pagination information"}},"type":"object"},"groups.GetActiveGroupsData":{"properties":{"groups":{"description":"Array of group entries","items":{"$ref":"#/components/schemas/groups.GroupSummary"},"type":"array","uniqueItems":false}},"type":"object"},"groups.GroupSummary":{"properties":{"created_at":{"description":"Creation timestamp (Unix)","type":"integer"},"id":{"description":"Group ID","type":"string"},"subject":{"description":"Group subject","type":"string"}},"type":"object"},"groups.GroupPaging":{"properties":{"cursors":{"$ref":"#/components/schemas/groups.GroupPagingCursors","description":"Pagination cursors"},"next":{"description":"URL for next page of results","type":"string"},"previous":{"description":"URL for previous page of results","type":"string"}},"type":"object"},"groups.GroupPagingCursors":{"properties":{"after":{"description":"Cursor for next page","type":"string"},"before":{"description":"Cursor for previous page","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/groups":{"get":{"description":"Retrieve list of active groups for a business phone number with pagination support.","operationId":"get-active-groups","parameters":[{"description":"Number of groups to fetch (1-1024, default 25)","in":"query","name":"limit","schema":{"type":"integer"}},{"description":"Cursor for pagination","in":"query","name":"after","schema":{"type":"string"}},{"description":"Cursor for pagination","in":"query","name":"before","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.GetActiveGroupsResponse"}}},"description":"Groups retrieved successfully"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Internal server error"}},"summary":"Get Active Groups","tags":["Groups"]}}}}
```

## Create Group

> Create a new WhatsApp group with specified subject, description, and join approval mode.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"Groups","description":"Endpoints for managing WhatsApp groups"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"groups.CreateGroupRequest":{"description":"Request payload to create a new WhatsApp group","properties":{"description":{"description":"Group description, max 2048 chars","type":"string"},"join_approval_mode":{"description":"Join approval mode: 'approval_required' or 'auto_approve'","type":"string"},"messaging_product":{"description":"Must be 'whatsapp'","type":"string"},"subject":{"description":"Group subject, max 128 chars. Whitespace is trimmed","type":"string"}},"type":"object"},"groups.CreateGroupResponse":{"description":"Response payload for a successfully created group","properties":{"id":{"description":"Newly created group ID","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/groups":{"post":{"description":"Create a new WhatsApp group with specified subject, description, and join approval mode.","operationId":"create-group","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.CreateGroupRequest","summary":"requestBody","description":"Group creation payload"}}},"description":"Group creation payload","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.CreateGroupResponse"}}},"description":"Group created successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Internal server error"}},"summary":"Create Group","tags":["Groups"]}}}}
```

## Get Group Information

> Retrieve detailed metadata about a specific group including participants and settings.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"Groups","description":"Endpoints for managing WhatsApp groups"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"groups.GetGroupInfoResponse":{"description":"Response payload containing detailed group metadata","properties":{"creation_timestamp":{"description":"Creation timestamp (Unix)","type":"integer"},"description":{"description":"Group description","type":"string"},"id":{"description":"Group ID","type":"string"},"join_approval_mode":{"description":"Join approval mode","type":"string"},"messaging_product":{"description":"Must be 'whatsapp'","type":"string"},"participants":{"description":"List of group participants","items":{"$ref":"#/components/schemas/groups.GroupParticipant"},"type":"array","uniqueItems":false},"subject":{"description":"Group subject","type":"string"},"suspended":{"description":"Whether the group is suspended","type":"boolean"},"total_participant_count":{"description":"Total number of participants","type":"integer"}},"type":"object"},"groups.GroupParticipant":{"properties":{"wa_id":{"description":"Participant phone number or WhatsApp ID","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/groups/{group_id}":{"get":{"description":"Retrieve detailed metadata about a specific group including participants and settings.","operationId":"get-group-info","parameters":[{"description":"Group ID","in":"path","name":"group_id","required":true,"schema":{"type":"string"}},{"description":"Comma-separated list of fields to return. Available fields: https://developers.facebook.com/documentation/business-messaging/whatsapp/groups/reference#available-fields","in":"query","name":"fields","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.GetGroupInfoResponse"}}},"description":"Group information retrieved successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Group not found"}},"summary":"Get Group Information","tags":["Groups"]}}}}
```

## Update Group Settings

> Update group subject, description, and profile picture.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"Groups","description":"Endpoints for managing WhatsApp groups"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"groups.UpdateGroupRequest":{"description":"Request payload to update group subject, description, and profile picture","properties":{"description":{"description":"New group description, max 2048 chars","type":"string"},"messaging_product":{"description":"Must be 'whatsapp'","type":"string"},"profile_picture_file":{"description":"Path to profile picture file (multipart upload)","type":"string"},"subject":{"description":"New group subject, max 128 chars. Must not be empty if provided","type":"string"}},"type":"object"},"groups.UpdateGroupResponse":{"description":"Response payload for a successful group update","properties":{"success":{"description":"Whether the update was successful","type":"boolean"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/groups/{group_id}":{"post":{"description":"Update group subject, description, and profile picture.","operationId":"update-group-settings","parameters":[{"description":"Group ID","in":"path","name":"group_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.UpdateGroupRequest","summary":"requestBody","description":"Update group settings payload"}},"multipart/form-data":{"schema":{"type":"object"}}},"description":"Update group settings payload","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.UpdateGroupResponse"}}},"description":"Group updated successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Group not found"}},"summary":"Update Group Settings","tags":["Groups"]}}}}
```

## Delete Group

> Delete the group and remove all participants permanently.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"Groups","description":"Endpoints for managing WhatsApp groups"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"groups.DeleteGroupResponse":{"description":"Response payload for successful group deletion","properties":{"success":{"description":"Whether the group was deleted","type":"boolean"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/groups/{group_id}":{"delete":{"description":"Delete the group and remove all participants permanently.","operationId":"delete-group","parameters":[{"description":"Group ID","in":"path","name":"group_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.DeleteGroupResponse"}}},"description":"Group deleted successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Group not found"}},"summary":"Delete Group","tags":["Groups"]}}}}
```

## Get Group Invite Link

> Retrieve the current invite link for a group that allows users to join.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"Groups","description":"Endpoints for managing WhatsApp groups"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"groups.GetInviteLinkResponse":{"description":"Response payload containing the group invite link","properties":{"invite_link":{"description":"Group invite URL","type":"string"},"messaging_product":{"description":"Must be 'whatsapp'","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/groups/{group_id}/invite_link":{"get":{"description":"Retrieve the current invite link for a group that allows users to join.","operationId":"get-group-invite-link","parameters":[{"description":"Group ID","in":"path","name":"group_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.GetInviteLinkResponse"}}},"description":"Invite link retrieved successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Group not found"}},"summary":"Get Group Invite Link","tags":["Groups"]}}}}
```

## Reset Group Invite Link

> Reset the invite link for a group, invalidating previous links.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"Groups","description":"Endpoints for managing WhatsApp groups"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"groups.ResetInviteLinkRequest":{"description":"Request payload for resetting a group invite link","properties":{"messaging_product":{"description":"Must be 'whatsapp'","type":"string"}},"type":"object"},"groups.ResetInviteLinkResponse":{"description":"Response payload containing the new group invite link","properties":{"invite_link":{"description":"New group invite URL","type":"string"},"messaging_product":{"description":"Must be 'whatsapp'","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/groups/{group_id}/invite_link":{"post":{"description":"Reset the invite link for a group, invalidating previous links.","operationId":"reset-group-invite-link","parameters":[{"description":"Group ID","in":"path","name":"group_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.ResetInviteLinkRequest","summary":"requestBody","description":"Request body"}}},"description":"Request body","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.ResetInviteLinkResponse"}}},"description":"Invite link reset successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Group not found"}},"summary":"Reset Group Invite Link","tags":["Groups"]}}}}
```

## Get Join Requests

> Retrieve list of pending join requests for a group requiring approval.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"Groups","description":"Endpoints for managing WhatsApp groups"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"groups.GetJoinRequestsResponse":{"description":"Response payload containing pending group join requests","properties":{"data":{"description":"Array of pending join requests","items":{"$ref":"#/components/schemas/groups.JoinRequest"},"type":"array","uniqueItems":false},"paging":{"$ref":"#/components/schemas/groups.GroupPaging","description":"Pagination information"}},"type":"object"},"groups.JoinRequest":{"properties":{"creation_timestamp":{"description":"Join request creation timestamp (Unix)","type":"integer"},"join_request_id":{"description":"Join request ID","type":"string"},"wa_id":{"description":"Requesting user's WhatsApp ID","type":"string"}},"type":"object"},"groups.GroupPaging":{"properties":{"cursors":{"$ref":"#/components/schemas/groups.GroupPagingCursors","description":"Pagination cursors"},"next":{"description":"URL for next page of results","type":"string"},"previous":{"description":"URL for previous page of results","type":"string"}},"type":"object"},"groups.GroupPagingCursors":{"properties":{"after":{"description":"Cursor for next page","type":"string"},"before":{"description":"Cursor for previous page","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/groups/{group_id}/join_requests":{"get":{"description":"Retrieve list of pending join requests for a group requiring approval.","operationId":"get-join-requests","parameters":[{"description":"Group ID","in":"path","name":"group_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.GetJoinRequestsResponse"}}},"description":"Join requests retrieved successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Group not found"}},"summary":"Get Join Requests","tags":["Groups"]}}}}
```

## Approve Join Requests

> Approve one or more pending join requests for a group.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"Groups","description":"Endpoints for managing WhatsApp groups"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"groups.JoinRequestActionRequest":{"description":"Request payload for approving or rejecting group join requests","properties":{"join_requests":{"description":"Array of join request IDs","items":{"type":"string"},"type":"array","uniqueItems":false},"messaging_product":{"description":"Must be 'whatsapp'","type":"string"}},"type":"object"},"groups.JoinRequestActionResponse":{"description":"Response payload for join request approval/rejection","properties":{"approved_join_requests":{"description":"Approved join request IDs","items":{"type":"string"},"type":"array","uniqueItems":false},"errors":{"description":"Top-level errors, if any","items":{"$ref":"#/components/schemas/groups.GroupError"},"type":"array","uniqueItems":false},"failed_join_requests":{"description":"Join requests that failed to process","items":{"$ref":"#/components/schemas/groups.FailedJoinRequest"},"type":"array","uniqueItems":false},"messaging_product":{"description":"Must be 'whatsapp'","type":"string"},"rejected_join_requests":{"description":"Rejected join request IDs","items":{"type":"string"},"type":"array","uniqueItems":false}},"type":"object"},"groups.GroupError":{"properties":{"code":{"description":"Error code","type":"integer"},"error_data":{"$ref":"#/components/schemas/groups.GroupErrorData","description":"Additional error details"},"message":{"description":"Error message","type":"string"},"title":{"description":"Error title","type":"string"}},"type":"object"},"groups.GroupErrorData":{"properties":{"details":{"description":"Error details","type":"string"}},"type":"object"},"groups.FailedJoinRequest":{"properties":{"errors":{"description":"Errors for the failed join request","items":{"$ref":"#/components/schemas/groups.GroupError"},"type":"array","uniqueItems":false},"join_request_id":{"description":"Failed join request ID","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/groups/{group_id}/join_requests":{"post":{"description":"Approve one or more pending join requests for a group.","operationId":"approve-join-requests","parameters":[{"description":"Group ID","in":"path","name":"group_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.JoinRequestActionRequest","summary":"requestBody","description":"Join request approval payload"}}},"description":"Join request approval payload","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.JoinRequestActionResponse"}}},"description":"Join requests approved successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Group not found"}},"summary":"Approve Join Requests","tags":["Groups"]}}}}
```

## Reject Join Requests

> Reject one or more pending join requests for a group.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"Groups","description":"Endpoints for managing WhatsApp groups"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"groups.JoinRequestActionRequest":{"description":"Request payload for approving or rejecting group join requests","properties":{"join_requests":{"description":"Array of join request IDs","items":{"type":"string"},"type":"array","uniqueItems":false},"messaging_product":{"description":"Must be 'whatsapp'","type":"string"}},"type":"object"},"groups.JoinRequestActionResponse":{"description":"Response payload for join request approval/rejection","properties":{"approved_join_requests":{"description":"Approved join request IDs","items":{"type":"string"},"type":"array","uniqueItems":false},"errors":{"description":"Top-level errors, if any","items":{"$ref":"#/components/schemas/groups.GroupError"},"type":"array","uniqueItems":false},"failed_join_requests":{"description":"Join requests that failed to process","items":{"$ref":"#/components/schemas/groups.FailedJoinRequest"},"type":"array","uniqueItems":false},"messaging_product":{"description":"Must be 'whatsapp'","type":"string"},"rejected_join_requests":{"description":"Rejected join request IDs","items":{"type":"string"},"type":"array","uniqueItems":false}},"type":"object"},"groups.GroupError":{"properties":{"code":{"description":"Error code","type":"integer"},"error_data":{"$ref":"#/components/schemas/groups.GroupErrorData","description":"Additional error details"},"message":{"description":"Error message","type":"string"},"title":{"description":"Error title","type":"string"}},"type":"object"},"groups.GroupErrorData":{"properties":{"details":{"description":"Error details","type":"string"}},"type":"object"},"groups.FailedJoinRequest":{"properties":{"errors":{"description":"Errors for the failed join request","items":{"$ref":"#/components/schemas/groups.GroupError"},"type":"array","uniqueItems":false},"join_request_id":{"description":"Failed join request ID","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/groups/{group_id}/join_requests":{"delete":{"description":"Reject one or more pending join requests for a group.","operationId":"reject-join-requests","parameters":[{"description":"Group ID","in":"path","name":"group_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.JoinRequestActionRequest","summary":"requestBody","description":"Join request rejection payload"}}},"description":"Join request rejection payload","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.JoinRequestActionResponse"}}},"description":"Join requests rejected successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Group not found"}},"summary":"Reject Join Requests","tags":["Groups"]}}}}
```

## Remove Group Participants

> Remove one or more participants from a group.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"Groups","description":"Endpoints for managing WhatsApp groups"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"groups.ModifyParticipantsRequest":{"description":"Participants: array of objects with user phone number or WhatsApp ID. Cannot be empty. Max 8.","properties":{"messaging_product":{"type":"string"},"participants":{"items":{"$ref":"#/components/schemas/groups.ParticipantUser"},"type":"array","uniqueItems":false}},"type":"object"},"groups.ParticipantUser":{"properties":{"user":{"type":"string"}},"type":"object"},"groups.RemoveParticipantsResponse":{"description":"Response payload for successful participant removal","properties":{"success":{"description":"Whether participants were removed","type":"boolean"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/groups/{group_id}/participants":{"delete":{"description":"Remove one or more participants from a group.","operationId":"remove-group-participants","parameters":[{"description":"Group ID","in":"path","name":"group_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.ModifyParticipantsRequest","summary":"request","description":"Request body"}}},"description":"Request body","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/groups.RemoveParticipantsResponse"}}},"description":"Participants removed successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Group not found"}},"summary":"Remove Group Participants","tags":["Groups"]}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.360dialog.com/docs/messaging-api/api-reference/groups.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
