Zoho Desk

this connector will interact with the zoho api to allow swimlane access to create, read and update zoho tickets prerequisites the zoho desk connector asset requires an url , client id , client secret and refresh token to interact with the api capabilities the zoho desk connector has the following capabilities create a ticket get a ticket update a ticket task setup create ticket you can get a department id by going to this link https //desk zoho com/support/swimlanetest/showhomepage do#setup/general/departments/active and clicking on the department you want in the url address bar, the number at the end of the url is the department id reference documentation please see the following link for any support regarding api functionality https //accounts zoho com/developerconsole https //accounts zoho com/developerconsole https //desk zoho com/deskapidocument#introduction https //desk zoho com/deskapidocument#introduction configurations oauth 2 0 client credentials authenticates using oauth 2 0 client credentials configuration parameters parameter description type required url a url to the target host string required redirect uri redirect uri string required client id the client id provided in the developer portal https //accounts zoho com/developerconsole https //accounts zoho com/developerconsole string required client secret the client secret provided in the developer portal string required org id view an http request in the browser or use the organizations api endpoint https //desk zoho com/api/v1/organizations https //desk zoho com/api/v1/organizations defaults to first id from api string optional code grant token string optional verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional actions create a ticket it creates a ticket in your helpdesk endpoint url /api/v1/tickets method post input argument name type required description entityskills array optional parameter for create a ticket subcategory string optional parameter for create a ticket cf object optional parameter for create a ticket cf permanentaddress object optional parameter for create a ticket cf dateofpurchase object optional parameter for create a ticket cf phone object optional parameter for create a ticket cf numberofitems object optional parameter for create a ticket cf url object optional url endpoint for the request cf secondaryemail object optional parameter for create a ticket cf severitypercentage string optional type of the resource cf modelname string optional name of the resource productid string optional unique identifier contactid string optional unique identifier subject string required parameter for create a ticket departmentid string required unique identifier contact string optional parameter for create a ticket uploads array optional parameter for create a ticket resolution string optional parameter for create a ticket duedate string optional date value channel string optional parameter for create a ticket description string optional parameter for create a ticket language string optional parameter for create a ticket priority string optional parameter for create a ticket classification string optional parameter for create a ticket responseduedate string optional date value output parameter type description status code number http status code of the response reason string response reason phrase entityskills array output field entityskills modifiedtime string time value ticketnumber string output field ticketnumber subcategory string output field subcategory statustype string type of the resource subject string output field subject duedate string date value departmentid string unique identifier channel string output field channel onholdtime object time value description string output field description language string output field language source object output field source appname object name of the resource extid object unique identifier type string type of the resource permalink object output field permalink appphotourl object url endpoint for the request resolution object output field resolution shareddepartments array output field shareddepartments file name string name of the resource file string output field file closedtime object time value example \[ { "status code" 200, "response headers" { "content length" "140", "content type" "application/json", "date" "thu, 23 nov 2023 20 37 23 gmt" }, "reason" "ok", "json body" { "entityskills" \[], "modifiedtime" "2016 06 21t12 50 04 000z", "ticketnumber" "773", "subcategory" "sub general", "statustype" "open", "subject" "real time analysis requirement", "duedate" "2016 06 21t18 50 04 573z", "departmentid" "1892000000006907", "channel" "email", "onholdtime" null, "description" "hai this is description", "language" "english", "source" {}, "resolution" null, "shareddepartments" \[] } } ] get a ticket it fetches a single ticket from your helpdesk endpoint url /api/v1/tickets/{{ticket id}} method get input argument name type required description ticket id string required unique identifier include string optional parameter for get a ticket output parameter type description status code number http status code of the response reason string response reason phrase modifiedtime string time value subcategory string output field subcategory statustype string type of the resource subject string output field subject duedate string date value departmentid string unique identifier channel string output field channel onholdtime object time value language string output field language source object output field source appname object name of the resource extid object unique identifier type string type of the resource permalink object output field permalink appphotourl object url endpoint for the request resolution object output field resolution shareddepartments array output field shareddepartments name string name of the resource id string unique identifier type string type of the resource closedtime object time value sharedcount string count value approvalcount string count value example \[ { "status code" 200, "response headers" { "content length" "140", "content type" "application/json", "date" "thu, 23 nov 2023 20 37 23 gmt" }, "reason" "ok", "json body" { "modifiedtime" "2016 06 21t13 16 14 000z", "subcategory" "sub general", "statustype" "open", "subject" "hi there is a sudden delay in the processing of the orders check this with hig ", "duedate" "2016 06 21t16 16 16 000z", "departmentid" "1892000000006907", "channel" "forums", "onholdtime" null, "language" "english", "source" {}, "resolution" null, "shareddepartments" \[], "closedtime" null, "sharedcount" "3", "approvalcount" "1" } } ] update a ticket it updates an existing ticket endpoint url /api/v1/tickets/{{ticket id}} method patch input argument name type required description ticket id string required unique identifier disableclosurenotification boolean optional parameter for update a ticket entityskills array optional parameter for update a ticket subcategory string optional parameter for update a ticket cf object optional parameter for update a ticket cf permanentaddress object optional parameter for update a ticket cf dateofpurchase object optional parameter for update a ticket cf phone object optional parameter for update a ticket cf numberofitems object optional parameter for update a ticket cf url object optional url endpoint for the request cf secondaryemail object optional parameter for update a ticket cf severitypercentage string optional type of the resource cf modelname string optional name of the resource productid string optional unique identifier contactid string optional unique identifier subject string optional parameter for update a ticket departmentid string optional unique identifier contact string optional parameter for update a ticket uploads array optional parameter for update a ticket resolution string optional parameter for update a ticket duedate string optional date value channel string optional parameter for update a ticket description string optional parameter for update a ticket language string optional parameter for update a ticket priority string optional parameter for update a ticket output parameter type description status code number http status code of the response reason string response reason phrase entityskills array output field entityskills modifiedtime string time value ticketnumber string output field ticketnumber subcategory string output field subcategory statustype string type of the resource subject string output field subject duedate string date value departmentid string unique identifier channel string output field channel onholdtime object time value description string output field description language string output field language source object output field source appname object name of the resource extid object unique identifier type string type of the resource permalink object output field permalink appphotourl object url endpoint for the request resolution object output field resolution shareddepartments array output field shareddepartments file name string name of the resource file string output field file closedtime object time value example \[ { "status code" 200, "response headers" { "content length" "140", "content type" "application/json", "date" "thu, 23 nov 2023 20 37 23 gmt" }, "reason" "ok", "json body" { "entityskills" \[], "modifiedtime" "2016 06 21t12 58 09 122z", "ticketnumber" "773", "subcategory" "sub general", "statustype" "open", "subject" "real time analysis requirement", "duedate" "2016 06 23t12 58 09 211z", "departmentid" "1892000000006907", "channel" "forums", "onholdtime" null, "description" "sample ticket", "language" "english", "source" {}, "resolution" null, "shareddepartments" \[] } } ] response headers header description example content length the length of the response body in bytes 140 content type the media type of the resource application/json date the date and time at which the message was originated thu, 23 nov 2023 20 37 23 gmt