Zabbix Documentation 2.0 (current)| In development:5.2 (devel)| Unsupported:

User Tools

Site Tools



This is an old revision of the document!

Table of Contents


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


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 add User to.
user_medias array No Create User Medias for User.


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


Create new user and added it to 3 user groups. Password “zabbix” will automaticly be encoded by MD5 hash function.

"method": "user.create",
"params": [{
	"usrgrps": [{
		"usrgrpid": "10009",
		"name": "Internal login"
		"usrgrpid": "10020",
		"name": "API access"
		"usrgrpid": "10022",
		"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": "originalblue",
	"attempt_failed": "0",
	"attempt_ip": "",
	"attempt_clock": "0",
	"rows_per_page": "50"
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 3

User added successfully:

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

User already exists:

"jsonrpc": "2.0",
"error": {
      "code": -32602,
      "message": "Invalid params.",
      "data": "User with alias "Admin" already exists."
"id": 3