Skip to main content

 Services

Web services from /about to /webhooks

invite self

/groups/{group}/members/inviteself [POST]

Description

Invite self to a group.

Allows a member to join themselves to a group in PageSeeder.

Group membership parameters

All group membership parameters are optional, and default to the group’s default values.

The notification parameter must be one of immediate, essential, daily, weekly or none.

The invitation behavior follows the value of Group Setting Self Registration as follows:

  • Normal – The member is joined immediately to the group.
  • Moderated – A request is emailed to a moderator who must approve it.
  • Confirmed – The member is sent an email with a link that they must follow.

Additional information specific to the group can also be attached to the user using the details fields field1 to field15.

Parameters

NameDescriptionRequiredTypeDefault
field1Custom field #1nostring
field2Custom field #2nostring
field3Custom field #3nostring
field4Custom field #4nostring
field5Custom field #5nostring
field6Custom field #6nostring
field7Custom field #7nostring
field8Custom field #8nostring
field9Custom field #9nostring
field10Custom field #10nostring
field11Custom field #11nostring
field12Custom field #12nostring
field13Custom field #13nostring
field14Custom field #14nostring
field15Custom field #15nostring
listedWhether the member’s email address is listed in the groupnobooleanfalse
notificationThe member’s notification option in the groupnostring
notify-asyncWhether to send emails asynchronously (for slow email servers)nobooleanfalse
welcome-emailWhether to send a welcome emailnobooleantrue

Permission

Anyone can invoke this service if the group visibility is defined as public.

Response

If successful, the created membership is returned as a <membership> element wrapped in a <membership-creation> element.

If the service attempted but failed to send the email notification to the user, it is indicated using one of:

<membership-creation [welcome-email-failed="true"]
                     [confirm-email-failed="true"]
                     [moderate-email-failed="true"]>
  <membership id="[membership id]"
              email-listed="[true|false]"
              notification="[notification]"
              status="[self-invited|moderated|normal]"
              role="[role]">
    <member id="[member id]"
            firstname="[first name]"
            surname="[surname]"
            username="[username]"
            status="[activated|unactivated|set-password]">
      <fullname>[full name]</fullname>
    </member>
    <group id="[group id]"
           name="[name]"
           visibility="[visibility]"
           template="[template]">
      <description>[description]</description>
    </group>
  </membership>
</membership-creation>

Error Handling

CodeCause / Description
0x1003If the specified group is a personal group
0x1023Invite to admin group not allowed
0x1025The member already belongs to the group
0x6004If the member details have not been configured properly
0x6005Group has no moderator with an email address (when Self Registration: Moderated)
Created on , last edited on