Add request

Add a request

URL
https://sdpondemand.manageengine.com/api/json/request

Method
HTTP POST

API description
Adds a request in the ServiceDesk Plus On-Demand application

Parameters to be passed
authtoken, scope, OPERATION_NAME (value is ADD_REQUEST) and INPUT_DATA

Sample INPUT_DATA:

{
   "operation": {
      "Details": {
         "REQUESTER": "Howard Stern",        
         "SUBJECT": "Subject of the request",
         "REQUESTTEMPLATE": "Default Request",
         "PRIORITY": "High",
         "LEVEL": "Tier 1",
         "IMPACT": "Affects Business",
         "URGENCY": "High",
         "DESCRIPTION": "Mail Server is down",
         "ATTACHMENT_IDS": ["1005","1006"],
         "UDF_CHAR1": "Test",
         "UDF_LONG1": "1001",
         "UDF_DATE1": "90080098767654",
         "EMAILS_TO_NOTIFY"  : "howard.stern@zillum.com"
       }
   }
}

Sample Request:

curl -d "scope=sdpodapi&authtoken=244c93bbd236cba1f03ea4af747e2b3a&
OPERATION_NAME=ADD_REQUEST&INPUT_DATA=
{operation:{Details:{REQUESTER:Chris Cullen, SUBJECT: Subject of the request,  
REQUESTTEMPLATE:Default Request, PRIORITY:High, URGENCY:High,  LEVEL :Tier 1, IMPACT:Affects Business, 
DESCRIPTION:Mail Server is down}}}" https://sdpondemand.manageengine.com/api/json/request

Sample Response:

{
   "operation": {
      "name": "ADD_REQUEST",
      "result": {
         "status": "Success",
         "message": "Request added successfully"
      },
      "Details": {
         "WORKORDERID": "10",
         "REQUESTER": "Howard Stern",
         "CREATEDBY": "Chris Cullen",
         "CREATEDTIME": "1348491035960",
         "DUEBYTIME": "1348491035960",
         "RESPONDEDTIME": "",
         "COMPLETEDTIME": "",
         "SHORTDESCRIPTION": "Mail Server is down",
         "TIMESPENTONREQ": "0hrs 0min",
         "SUBJECT": "Subject of the request",
         "REQUESTTEMPLATE": "Default Request",
         "MODE": "",
         "SLA": "High SLA",
         "ASSET": "",
         "DEPARTMENT": "",
         "SITE": "Not in any site",
         "CATEGORY": "",
         "SUBCATEGORY": "",
         "ITEM": "",
         "TECHNICIAN": "tech1",
         "STATUS": "Open",
         "PRIORITY": "High",
         "LEVEL": "Tier 1",
         "IMPACT": "Affects Business",
         "URGENCY": "High",
         "IMPACT DETAILS": "",
         "REQUESTTYPE": "",
         "GROUP": "",
         "UDF_CHAR1": "Test",
         "UDF_LONG1": "1001",
         "UDF_DATE1": "90080098767654",
         "EMAILS_TO_NOTIFY"  : "howard.stern@zillum.com"
       }
   }
}

Fields for INPUT_DATA

The following are the fields that can be give in the Input data for Add Request :

REQUESTTEMPLATE, SUBJECT, DESCRIPTION, RESOLUTION, REQUESTER, REQUESTEREMAIL, 
PRIORITY, LEVEL, STATUS, MODE, URGENCY, IMPACT, IMPACTDETAILS, REQUESTTYPE, SITE, CATEGORY, 
SUBCATEGORY, ITEM, GROUP, TECHNICIAN, TECHNICIANEMAIL, EMAILS_TO_NOTIFY, Request Additional Fields

Note:

• If no Template name is specified during add request, "Default Template" will be used
• If there is no value given for a field, and if there is a default value available in the Template for that field, then the default value will be used while adding the request. 
• For mandatory fields, if the default value is not available in the Template, the request will not be added and error message will be returned
• Use the "Save Attachment" api to upload and save an attachment. You will get a file id in return. The file id can be passed to ATTACHMENT_IDS while adding the request