MAPI Manual

NAME

ADD_USER

FUNCTION

Add a user to an organisation

SYNOPSIS

DESCRIPTION

This function adds a user to an organisation. Admin users are allowed to add Manager users. Account manager users can add Admin users.

Required Parameters

* action: ADD_USER.
* user_login_name: specifies the user login name. Value must be in the form of email address.
* group_id: group ID.
* user_login_password: specifies the password for login.
* userid_password:
* first_name: firstname of the user.
* middle_name: middle name.
* last_name: lastname.
* org_id: organisation ID.
* is_active: specifies whether the status of the user is active or not. "1" means active; "0" otherwise.
* role: user role. The values are "manager", "admin" and "accountmanager".
* access_control: specifies the access rights.
* access_apps_control: specifies the access rights to the apps.
* mcp_language_id: language ID. To get the list of supported languages, see LIST_LANGUAGES.

* mcp_location_id: location ID. To get the list of countries, see LIST_LOCATIONS.

* tz_abbr: the time zone abbreviation. To get the list of time zones, see LIST_TIMEZONES.

* fax_number: fax number.
* mobile: mobile number.
* org_department: department of the organisation.
* org_position: position in the organisation.

RETURN DATA

The response contains the following attribute:
* mcp_user_id: ID of the user.

ROLE PERMITTED

Admin, Account Manager

EXAMPLES

The following example shows a successful HTTP GET request and response. In this example, the role of the logged-in user is Admin, and therefore a Manager user will be created.

Request:

http://app02.yvntech.com/MapIHttpS/MapIS?action=ADD_USER&user_login_name=stephen%40example.com&user_login_password=2222&first_name=stephen&last_name=smith&org_id=9000&is_active=1&role=manager&access_control=1&access_apps_control=MCPTYPE_ALL&mcp_language_id=1&mcp_location_id=61&mobile=%2B61422222222&tz_abbr=TZ89&login_name=Admin@example.com&login_passwd=1111

Response:

 <result tftype='1' infotype='0'>
            <field name='mcp_user_id'>11000010</field>
 </result>

TIPS

ENVIRONMENT

AUTHOR

YVN Tech

SEE ALSO

UPDATE_USER

Mweb v2.0 YVNTECH 2014