create membership
| API Support | Available since | Last updated | Output |
|---|---|---|---|
Description
Creates a new member in PageSeeder and invite the member to a group.
Member details
Both the firstname and surname are limited to 20 characters. If the first name is not specified, it defaults to Member.
The member-username must be less than 100 characters, unique and cannot contain a ‘@’. The username is required unless the an email address is specified.
The email must be less than 100 characters, unique and be a valid Email address. The email address is required unless a username is specified.
Password details
The member-password must be less than 100 characters. When the Password is not specified, the member’s email is used if no confirmation is needed, otherwise a new password is generated.
Passwords must satisfy a given strength check to be accepted:
- Regular members must have at least a MEDIUM strength
- Administrators must use a STRONG password
Other member options
It is possible to create a personal group using the personal-group boolean parameter.
To send a welcome email to the new member, use the welcome-email boolean parameter.
The account can be automatically activate by using the auto-activate boolean parameter.
Group membership parameters
If a group is specified on the request, the new member is also added to the group. All group membership parameters are optional, and default to the group’s default values.
The notification parameter must be one of immediate, daily or none. Users are able to subsequently change this setting through the user interface in their group registration options.
The role parameter must be one of guest, reviewer, contributor, manager, approver, moderator-and-approver, moderator.
The listed boolean parameter can be used to override the group’s default setting. It affects whether other group member are able to see the member’s user details. Users are able to subsequently change this setting through the user interface in their group registration options.
The invitation parameter can be used to force the group invitation email to be sent to the new member, or to prevent that email to be sent. The default behavior follows the value of the project property acceptInvitationRequired.
Additional information specific to the group can also be attached to the user using the details fields field1 to field15.
Parameters
| Name | Description | Required | Type | Default |
|---|---|---|---|---|
| The new member’s email required if no member-username) | maybe | string | ||
| auto-activate | Whether to activate the new member automatically | no | boolean | false |
| blank-password | no | string | ||
| field1 | no | string | ||
| field10 | no | string | ||
| field11 | no | string | ||
| field12 | no | string | ||
| field13 | no | string | ||
| field14 | no | string | ||
| field15 | no | string | ||
| field2 | no | string | ||
| field3 | no | string | ||
| field4 | no | string | ||
| field5 | no | string | ||
| field6 | no | string | ||
| field7 | no | string | ||
| field8 | no | string | ||
| field9 | no | string | ||
| firstname | The new member’s given/other name | no | string | Member |
| invitation | Whether to create an invitation, otherwise force membership | no | boolean | |
| listed | Whether the member’s email address is listed in the group | no | boolean | false |
| member-password | The new member’s password, is generated if unspecified | no | string | |
| member-username | The new member’s username, defaults to the member's email | no | string | |
| notification | The member’s notification option in the group | no | string | |
| personal-group | Whether to create the personal group | no | boolean | false |
| role | The member’s role in the group | no | string | |
| surname | The new member’s family name | no | string | [4 digits] |
| welcome-email | Whether to send a welcome email to the new member | no | boolean | true |
Permission
This service requires administrator.
Response
<membership-creation [welcome-email-failed="true"]>
<membership id="[membershipid]"
email-listed="[true|false]"
notification="[none|immediate|daily]"
flags="[flags]"
status="[invited|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|project id="[group id]"
name="[name]"
flags="[flags]"
visibility="[visibility]"
template="[template]">
<description>[description]</description>
</group|project>
</membership>
</membership-creation>