This is the documentation page for an unsupported version of Zabbix.
Is this not what you were looking for? Switch to the current version or choose one from the drop-down menu.

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.
user_medias
(deprecated)
array This parameter is deprecated, please use medias instead.
User media to be created.

Return values

(object) Returns an object containing the IDs of the created users under the userids property. The order of the returned IDs matches the order of the passed users.

Examples

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:

{
           "jsonrpc": "2.0",
           "result": {
               "userids": [
                   "12"
               ]
           },
           "id": 1
       }

See also

Source

CUser::create() in ui/include/classes/api/services/CUser.php.