# API: Create new Event
# addSUStatus
Create new Event with ability to enable/disable notifications.
# Optional parameters
Parameter | Description |
---|---|
template | Template ID |
name[language_id] | Event name/subject. Required if template ID is empty |
description[language_id] | Event description. Required if template ID is empty |
date | Event date in Y-m-d format(default now) |
status | Event status. Allowed values: Scheduled (default), InProgress, Cancelled, ResolvedFaultIssue, CompletedMaintenance, Finished |
startdate | Event start datetime in Y-m-d H:i:s format (default now) |
enddate | Event finish datetime in Y-m-d H:i:s format (default now) |
relatedinfo[language_id] | Event related servers information |
notification | Show Notification in clientarea. Allowed values: "no" - don't show (default); "yes" - show from the "Date" till the "Finish time"; "yes_active" - show from the "Start time" till "Finish time" |
type_id | Event type ID |
notify | Notify affected clients. When parameter exists at least one server, product or zone must be added |
servers[] | Related servers |
products[] | Related products |
zones[] | Notification zones |
notifysubzones | Clients with services in subzones will also be notified |
notifymethod | Notification method. Allowed values: ticket, email, mobile. Required when "notify" => true |
department | Ticket department ID. Required when "notify_method" => ticket |
meta[template_id] | Notification message template ID |
subject_fromtemplate | Subject From Template |
message_fromtemplate | Message From Template |
save_as_template | Save Event as template |
template_name | New template name. Required when "save_as_template" => true |
# Request
GET /admin/api.php?api_id=API_ID&api_key=API_KEY&call=addSUStatus
# PHP Samples
# PHP Samples: Create new Event from a template
# PHP Samples: Create new Event with save as template options
# PHP Samples: Create new Event from not from a template
# PHP Samples: Create new Event with notify affected clients via ticket in related products and related servers
# PHP Samples: Create new Event with notify affected clients via email in notification zones
# Response
{
"success": true,
"info": "A new event created",
"id": 1,
"template_id": 1,
"call": "addSUStatus",
"server_time": 1749036610
}