Documentation
Table of Contents
user.create
Description
object user.create(object/array users)
This method allows to create new users.
This method is only available to Super admin user type. Permissions to call the method can be revoked in user role settings. See User roles for more information.
The strength of user password is validated according the password policy rules defined by Authentication API. See Authentication API for more information.
Parameters
(object/array) Users to create.
Additionally to the standard user properties, the method accepts the following parameters.
| Parameter | Type | Description |
|---|---|---|
| passwd (required) |
string | User's password. Can be omitted if user is added only to groups that have LDAP access. |
| usrgrps (required) |
array | User groups to add the user to. The user groups must have the usrgrpid property defined. |
| medias | array | User media to be created. |
Valori di ritorno
(object) Restituisce un oggetto contenente gli ID degli utenti creati sotto la proprietà userids. L'ordine degli ID restituiti corrisponde all'ordine degli utenti passati.
Esempi
Creating a user
Create a new user, add him to a user group and create a new media for him.
Request:
{
"jsonrpc": "2.0",
"method": "user.create",
"params": {
"username": "John",
"passwd": "Doe123",
"roleid": "5",
"usrgrps": [
{
"usrgrpid": "7"
}
],
"medias": [
{
"mediatypeid": "1",
"sendto": [
"[email protected]"
],
"active": 0,
"severity": 63,
"period": "1-7,00:00-24:00"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Response:
See also
Fonte
CUser::create() in ui/include/classes/api/services/CUser.php.