Community Invitation

The community invitation system allows community moderators and administrators to invite users to join their communities. This feature provides a controlled way to grow community membership by extending personalized invitations to specific users.

Network-Level Membership Settings

Your network can be configured with different membership acceptance modes that affect how invitations work:

  • Automatic membership: Invited users become members immediately upon invitation

  • Invitation acceptance: Users must explicitly accept invitations to become members (provides user consent and control)

Invitation Types

Direct Invitation

  • Immediate membership: User becomes a member instantly when invited (automatic membership mode)

  • No user action required: Membership is activated without user intervention

  • Notification sent: User receives notification about being added to the community

Invitation with Acceptance

  • User consent required: User must accept the invitation to join (invitation acceptance mode)

  • Pending status: Invitation remains pending until user responds

  • User control: Users can accept or decline invitations

Invitation Process

When using invitation acceptance mode:

  1. Send Invitation: Moderator sends invitation to specific user

  2. User Notification: User receives invitation notification

  3. User Decision: User can accept or decline the invitation

  4. Membership Activation: Upon acceptance, user becomes community member

  5. Confirmation: Both parties receive confirmation of membership

Managing Invitations

For Users

Get My Community Invitations

The getMyCommunityInvitations function allows users to retrieve all their pending community invitations. This helps users see which communities they've been invited to join and manage their invitation responses.

Check Community Invitation Status

This function retrieves the current status of a community invitation. It helps users understand if their invitation is still pending, has been accepted, rejected, or canceled. Users can then take appropriate actions based on the status of their invitations.

Returns invitation status: 'pending', 'accepted', 'rejected' or 'cancelled'

Accept Invitation

The acceptInvitation function allows users to accept pending community invitations. This function is only relevant when the network is configured for invitation acceptance mode.

Decline Invitation

The declineInvitation function allows users to decline pending community invitations.

For Moderators

Send Invitation

Moderators can send invitations to users to join the community:

Get Sent Invitations

Moderators can view all invitations they've sent:

Last updated

Was this helpful?