Skip to main content

 Services

Web services from /about to /webhooks

import members

/members/import [POST]

Description

Imports members into PageSeeder.

The data parameter uses comma separated values as:

[firstname],[surname],[email],[username?],[password?]

The first three fields are always required. Password is also required for new members.

If a value contains a comma, it should be wrapped by double quotes ". It is not possible to include a line delimiter in a value, line delimiters are automatically interpreted as a separate member.

Error handling

If a user already exist, the existing details are returned instead of the original details sent in the request. The details sent in the import data do NOT overwrite the existing data.

If the data is incomplete or the email or username is invalid, it will return status="error" for that member.

The returned XML is as follows:

 <members-import>
   <import firstname="[first name]"
           surname="[surname]"
           email="[email]"
           username="[username]"
           status="[created|existing|error]"
          [id="[member id]"]
          [personal-group-created="true"]
          [error=""] />
   ...
 </members-import>
 

Parameters

Name Description Required Type Default value
createpersonal Whether to create a personal group for each member no string false
data the members to be imported in CSV format yes string

Permission

This service requires Administrator.

Response

The returned XML is as follows:

 <members-import>
   <import firstname="[first name]"
           surname="[surname]"
           email="[email]"
           username="[username]"
           status="[created|existing|error]"
          [id="[member id]"]
          [personal-group-created="true"]
          [error=""] />
   ...
 </members-import>
 

Error Handling

No specific errors expected for this generator.

Created on , last edited on