> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: wix-groups-backend

## Namespace: join-requests

## Article: Introduction

## Article Link: https://dev.wix.com/docs/velo/apis/wix-groups-backend/join-requests/introduction.md

## Article Content:

# Introduction
The JoinRequests API provides functionality for managing requests to join a group.

> **Notes:** 
> + This module is only relevant for private groups. 
> + When a group's `privacyStatus` is updated from `PRIVATE` to `PUBLIC`, all pending join requests for that group are automatically approved.
> + When a group's `privacyStatus` is updated from `PRIVATE` to `SECRET`, all pending join requests for that group are automatically rejected. 
> + A site member can only join a group if they have a [public profile](https://support.wix.com/en/article/wix-groups-member-privacy-settings-for-groups).
  
### Settings for Typical Use Case
+ Group members with group admin permissions determine who can join their group by setting their group [privacy level](https://support.wix.com/en/article/wix-groups-about-groups#your-groups-privacy-permissions).
+ If a group's privacy level is set to `PRIVATE`, a site member can request to join the group on your site's Groups List page.
+ Only site admins or group admins can approve or reject site member requests to join the group, unless the group setting `membersCanApprove` is set to `true`. 
+ **Note:** If the `suppressAuth` option is set to `true`, all permissions are overwritten, and all site members (including non-group members) can approve or reject site member requests to join a group. 
+ When a site member's request to join the group is approved, the member is added to the group. 
+ If a group's privacy level is set to `PUBLIC`, a site member can join the group (no request necessary). 
+ If a group's privacy level is set to `SECRET`, only site members added by an existing group member can join the group (no request necessary). 
 
The JoinRequests API provides functionality allowing you to:  
 + [Approve](https://dev.wix.com/docs/velo/apis/wix-groups-backend/join-requests/approve-join-requests.md) requests to join a group. 
 + [List](https://dev.wix.com/docs/velo/apis/wix-groups-backend/join-requests/list-join-requests.md) requests to join a group. 
 + [Query](https://dev.wix.com/docs/velo/apis/wix-groups-backend/join-requests/query-join-requests.md) requests to join a group.
 + [Reject](https://dev.wix.com/docs/velo/apis/wix-groups-backend/join-requests/reject-join-requests.md) requests to join a group. 

### Permissions Information
>**Note:** You can override the permissions below by setting the `suppressAuth` option to `true`. 

|Functions|Permissions
|--|---|
| `approveJoinRequests()`, `listJoinRequests()`, <br/> `queryJoinRequests()`, `rejectJoinRequests()`|Site admin, group admin


To use the JoinRequests API, import `joinRequests` from the `wix-groups-backend` module:

```javascript
import { joinRequests } from "wix-groups-backend";
```