Zabbix Documentation 1.8

3.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.22.43.23.4

User Tools

Site Tools


Sidebar

api:user:addmedia

Table of Contents

addMedia()

Available since version: 1.8

Parameters

Multidimensional array with user data and user media data.

ParameterTypeOptionalDescriptionDetails
usersarray User objects to update
mediasarray Yes Media objects, which should be added to users.

Returns

ParameterDescription
resultOperation successful. Result will contain an array of updated user IDs.
errorIn case of any errors.

Example

Add two enabled media to user with ID “100100000010092”

{
"jsonrpc":"2.0",
"method":"user.addMedia",
"params":{ 
"users": [
  { "userid": "100100000010092" }
],
"medias": [
  {"mediatypeid": "100100000000001", "sendto": "[email protected]", "active": "0", "severity": "56", "period": "5-7,09:00-17:00;"},
  {"mediatypeid": "100100000000002", "sendto": "[email protected]", "active": "0", "severity": "63", "period": "1-5,07:00-19:00;"}
]
},
"auth":"f223adf833b2bf2ff38574a67bba6372",
"id":2
}

User media added successfully:

{
"jsonrpc":"2.0",
"result":{
   "userids":["100100000010092"]
},
"id":2
}