listJoinRequests( )


Lists requests to join a group.

Note: This function is only relevant for private groups.

The listJoinRequests() function returns a Promise that resolves to a list of up to 100 requests to join a group. Sorts by default to _createdDate in descending order. Only site admins and group admins can see requests to join their group. Site members can access their own join requests in their site.

Notes:

  • If the suppressAuth option is set to true, all permissions are overwritten, and all site members (including non-group members) can see requests to join a group.
  • This function's parameters are positional, and must be specified in the sequence shown in the syntax below. When specifying a parameter, use null as a placeholder for any unspecified parameters. For example, to specify limit only, call listJoinRequests(groupId, paging, null). To specify supressAuth only, call listJoinRequests(groupId, null, options).
Method Declaration
Copy
function listJoinRequests(
  groupId: string,
  paging: Paging,
  options: Options,
): Promise<ListJoinRequests>;
Method Parameters
groupIdstringRequired

ID of the group requested to join.


pagingPaging

Paging options.


optionsOptions

Authorization options.

Returns
Return Type:Promise<ListJoinRequests>
JavaScript
import { Permissions, webMethod } from "wix-web-module"; import { joinRequests } from "wix-groups-backend"; // Sample groupId value: // 'fc3df3c1-36b2-4279-8be1-8e72a05a88c8' export const myListJoinRequestsFunction = webMethod( Permissions.Anyone, (groupId) => { return joinRequests .listJoinRequests(groupId) .then((joinRequestsResults) => { const joinRequestStatus = joinRequestsResults.joinRequests[0].status; return joinRequestsResults; }) .catch((error) => { console.error(error); }); }, ); /* Promise resolves to: * joinRequests: [ * { * "memberId": "937cd3db-e9be-4980-93c1-a6d767a11050" * "_createdDate": "Wed May 14 2021 10:05:20 GMT+0300" * "status": "REJECTED" * "rejectionReason": "Wrong group." * }, * { * "memberId": "7fe8e9e1-d050-4c86-9684-e7f231600a34" * "_createdDate": "Sun July 11 2020 03:25:30 GMT+0300" * "status": "PENDING" * } * ], * metadata: * { * "length": 2 * "tooManyToCount": false * "totalCount": 5 * } */
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Did this help?