create()

This function allows you to create a user as defined by the user data array. Available only to super admins.

Parameters

Parameter	Type	Optional	Description	Details
user data	array or object	No	Array of user objects or a single object	userid shouldn't be specified
usrgrps	array	No	User groups to add user to.
user_medias	array	No	Create user media for user.

Returns

Parameter	Description
result	Operation successful. Result will contain an array of created user IDs. userid is assigned to each user object.
error	In case of any errors.

Example

Create new user and add it to 3 user groups. Password "zabbix" will automatically be encoded by MD5 hash function.

{
       "jsonrpc":"2.0",
       "method":"user.create",
       "params":[{
           "usrgrps":[{
               "usrgrpid":"100100000000009",
               "name":"Internal login"
           },{
               "usrgrpid":"100100000000020",
               "name":"API access"
           },{
               "usrgrpid":"100100000000022",
               "name":"Debug group"
           }],
           "alias":"Test User",
           "name":"Test User Name",
           "surname":"Test User Surname",
           "passwd":"zabbix",
           "url":"",
           "autologin":"0",
           "autologout":"600",
           "lang":"en_gb",
           "refresh":"90",
           "type":"1",
           "theme":"css_ob.css",
           "attempt_failed":"0",
           "attempt_ip":"",
           "attempt_clock":"0",
           "rows_per_page":"50"
       }],
       "auth":"038e1d7b1735c6a5436ee9eae095879e",
       "id":3
       }

User added successfully:

{
       "jsonrpc":"2.0",
       "result":{
          "userids": ["107819"]
       },
       "id":3
       }

User already exists:

{
       "jsonrpc":"2.0",
       "error":{
             "code":-32602,
             "message":"Invalid params.",
             "data":"[ CUser::create ] User [ Admin ] already exists"
       },
       "id":3
       }

Documentation

create()

Parameters

Returns

Example