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.

Settings for Typical Use Case

  • Group members with group admin permissions determine who can join their group by setting their group privacy level.
  • 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 requests to join a group.
  • List requests to join a group.
  • Query requests to join a group.
  • Reject requests to join a group.

Permissions Information

Note: You can override the permissions below by setting the suppressAuth option to true.

FunctionsPermissions
approveJoinRequests(), listJoinRequests(),
queryJoinRequests(), rejectJoinRequests()
Site admin, group admin

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

Copy
Was this helpful?
Yes
No