Skip to content

ServiceDesk Plus

ServiceDesk Plus ServiceDesk Plus is a comprehensive service desk software that offers a suite of IT Service management, IT asset management, CMDB, and more.

Use the ServiceDesk Plus to efficiently manage Assets and Configuration Items for integrations.

API Documentation

This component was built using the ServiceDesk Plus V3 API Reference.

Connections

OAuth 2.0 {#sdp-oauth2}

OAuth 2.0 connection for ServiceDesk Plus

Self Client Applications are stand-alone applications that perform only back-end jobs (without any manual intervention) like data sync.

To register a new app as a Self Client Application for Configuration OAuth credential:

  1. Navigate to Zoho API Console and select GET STARTED.
  2. Find the Self Client Applications box and select CREATE NOW.
  3. In the Generate Code tab enter the Scopes, Time Duration needed for the code, and a brief description and select CREATE
  4. Example scopes: SDPOnDemand.cmdb.READ,SDPOnDemand.assets.READ
  5. When the Generated Code is provided, copy and/or download the code and enter in the connection configuration of the integration.
  6. In the Client Secret tab, copy and enter the Client ID, and Client Secret into the connection configuration of the integration.

Additionally, Server Based Applications may be used for setting up applications running on a dedicated HTTP server.

To register a new app as a Server-based Application for configuring OAuth credentials:

  1. Navigate to Zoho API Console and select GET STARTED.
  2. Find the Server-based Applications box and select CREATE NOW.
  3. Provide a Client Name, Homepage URL, and enter the Authorized Redirect URI as - https://oauth2.arenasolutions.com/callback
  4. Select CREATE and the Client ID and Client Secret credentials will be provided and can be entered into the connection configuration of the integration.

Please refer to the following Client OAuth Setup Guide for further information on OAuth setup.

This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works here.

Input Comments Default
Authorize URL The OAuth 2.0 Authorization URL for ServiceDesk Plus https://accounts.zoho.com/oauth/v2/auth?access_type=offline
Token URL The OAuth 2.0 Token URL for ServiceDesk Plus https://accounts.zoho.com/oauth/v2/token
Scopes A comma-delimited set of one or more scopes to get the user's permission to access. Refer to https://www.manageengine.com/products/service-desk/sdpod-v3-api/getting-started/oauth-2.0.html#scopes SDPOnDemand.assets.ALL SDPOnDemand.cmdb.ALL SDPOnDemand.setup.ALL
Client ID
Client Secret
Data Center

Actions

Create Asset {#createasset}

Create a new asset

Input Comments Default
Asset Name Unique name to identify the asset
State Indicates the state of the asset. Remove the default value if not needed. {
"name": "test-state",
"id": "234567890123456"
}
Product Product of the asset. Remove the default value if not needed. {
"name": "test-product",
"id": "234567890123456"
}
Asset ID Unique identifier to identify the asset
Asset Tag Asset tag used to identify the asset
State History Comments A text in a plain format. No rich text or new line characters allowed.
Bar Code Unique barcode used to identify the asset
Extra parameters Additional parameters to add to the request
Connection

Create Configuration Item {#createconfigurationitem}

Create a new configuration item on the CMDB

Input Comments Default
CI Type API Name Denotes the unique identifier used to identify the CI.
Name Indicates the unique name used to identify the CI
Description Description of the CI
Attributes Other attributes to add to the payload {
"txt_ip_address": "127.0.0.1"
}
Connection

Create Problem {#createproblem}

Create a new problem

Input Comments Default
Connection
Problem Title Title of the problem.
Problem Description Description of the problem.
Problem Reported Time Indicates the reported time of the problem. See ServiceDesk Plus API documentation for details.
Problem Due By Time Indicates the due by time of the problem. See ServiceDesk Plus API documentation for details.
Problem Closed Time Indicates the closed time of the problem. See ServiceDesk Plus API documentation for details.
Additional Fields Additional fields that might not be covered by the standard inputs. See ServiceDesk Plus API documentation for details.

Create Problem Note {#createproblemnote}

Create a new problem note

Input Comments Default
Connection
Problem ID ID of the problem.
Note Description Contains description about the note.
Notify To Contains info on users or roles to be notified on add/edit operation of the note. See ServiceDesk Plus API documentation for details.
Additional Fields Additional fields that might not be covered by the standard inputs. See ServiceDesk Plus API documentation for details.

Create Problem Task {#createproblemtask}

Create a problem task

Input Comments Default
Connection
Problem ID ID of the problem.
Task Title Title of the task.
Task Description Contains description about the task.
Task Type Used to categorize the tasks of similar cases. See ServiceDesk Plus API documentation for details.
Owner The User assigned to the task. See ServiceDesk Plus API documentation for details.
Estimated Effort Minutes Estimated number of minutes to finish the task.
Estimated Effort Hours Estimated number of hours to finish the task.
Estimated Effort Days Estimated number of days to finish the task.
Percentage Completion Indicates the progress of the task in percentage of completion.
Group Indicates the assigned group of the task. See ServiceDesk Plus API documentation for details.
Additional Fields Additional fields that might not be covered by the standard inputs. See ServiceDesk Plus API documentation for details.

Create Product {#createproduct}

Create a new product

Input Comments Default
Product Type Product type of the product. Remove the default value if not needed. {
"name": "test-product_type",
"id": "234567890123456"
}
Name Unique identifier to identify the resource
ID Unique identifier to identify the resource
Manufacturer Name to identify the product manufacturer.
Is Laptop Boolean value indicating whether the product type is laptop or not.
Part No Part no of the productPart no of the product
Attributes Other attributes to add to the payload
Connection

Create Product Type {#createproducttype}

Create a new product type

Input Comments Default
Name Unique identifier to identify the resource
Category Category of the product type. Remove the default value if not needed. {
"name": "Non-IT",
"id": "234567890123456"
}
Asset Type Type of the product type. Remove the default value if not needed. {
"name": "Asset",
"id": "234567890123456"
}
ID Unique identifier to identify the resource
Attributes Other attributes to add to the payload
Connection

Create Request {#createrequest}

Create a new request

Input Comments Default
Connection
Request Subject Subject of this request.
Request Description Description of this request.
Impact Details Description about the impact of this request.
Email IDs To Notify Email ids, which needs to be notified about the happenings of this request.
Delete Pre Template Tasks Boolean value indicating whether the pre template tasks need to be deleted. false
Additional Fields Additional fields that might not be covered by the standard inputs. See ServiceDesk Plus API documentation for details.

Create Request Task {#createrequesttask}

Create a new request task

Input Comments Default
Connection
Request ID ID of the request.
Request Task Title Title of the task.
Request Task Percentage Completion Indicates the progress of the task in percentage of completion.
Request Task Estimated Effort Hours Estimated number of hours to finish the task.
Request Task Description Contains description about the task.
Request Task Owner The User assigned to the task. See ServiceDesk Plus API documentation for details.
Request Task Additional Cost Cost spent other than the actual cost of the task.
Request Task Actual End Time Date and time at which the task actually got finished. See ServiceDesk Plus API documentation for details.
Request Task Actual Start Time Date and time at which the task actually got started. See ServiceDesk Plus API documentation for details.
Additional Fields Additional fields that might not be covered by the standard inputs. See ServiceDesk Plus API documentation for details.

Delete Asset {#deleteasset}

Delete an existing asset

Input Comments Default
Asset ID Unique identifier to identify the asset
Connection

Delete Configuration Item {#deleteconfigurationitem}

Delete an existing configuration item on the CMDB

Input Comments Default
CI Type API Name Denotes the unique identifier used to identify the CI.
CI IDs Unique identifier used to identify the CI.
Connection

Delete Problem {#deleteproblem}

Delete a problem by ID

Input Comments Default
Connection
To Delete Problem ID ID of the problem to be deleted.

Delete Problem Note {#deleteproblemnote}

Delete a problem note

Input Comments Default
Connection
Problem ID ID of the problem.
To Delete Note ID ID of the note to be deleted.

Delete Problem Task {#deleteproblemtask}

Delete a problem task

Input Comments Default
Connection
Problem ID ID of the problem.
To Delete Task ID ID of the task to be deleted.

Delete Product {#deleteproduct}

Delete a single product

Input Comments Default
ID Unique identifier to identify the resource
Connection

Delete Product Type {#deleteproducttype}

Delete a single product type

Input Comments Default
ID Unique identifier to identify the resource
Connection

Delete Request {#deleterequest}

Delete a request by ID

Input Comments Default
Connection
To Delete Request ID ID of the request to be deleted.

Delete Request Task {#deleterequesttask}

Delete a request task by ID

Input Comments Default
Connection
Request ID ID of the request.
To Delete Request Task ID ID of the task to be deleted.

Get Asset {#getasset}

Retrieve a single asset

Input Comments Default
Asset ID Unique identifier to identify the asset
Connection

Get Configuration Item {#getconfigurationitem}

Retrieve a single configuration item on the CMDB

Input Comments Default
CI Type API Name Denotes the unique identifier used to identify the CI.
CI ID Denotes the unique identifier used to identify the CI.
Connection

Get Problem {#getproblem}

Get a problem by ID

Input Comments Default
Connection
To Get Problem ID ID of the problem to be retrieved.

Get Problem Note {#getproblemnote}

Get a problem note

Input Comments Default
Connection
Problem ID ID of the problem.
To Get Note ID ID of the note to be retrieved.

Get Problem Task {#getproblemtask}

Get a problem task

Input Comments Default
Connection
Problem ID ID of the problem.
To Get Task ID ID of the task to be retrieved.

Get Product {#getproduct}

Retrieve a single product

Input Comments Default
ID Unique identifier to identify the resource
Connection

Get Product Type {#getproducttype}

Retrieve a single product type

Input Comments Default
ID Unique identifier to identify the resource
Connection

Get Request {#getrequest}

Get a request by ID

Input Comments Default
Connection
To Get Request ID ID of the request to be retrieved.

Get Request Task {#getrequesttask}

Get a request task by ID

Input Comments Default
Connection
Request ID ID of the request.
To Get Request Task ID ID of the task to be retrieved.

List Assets {#listassets}

Retrieve a list of assets

Input Comments Default
Conditions Criteria Conditions are the operators for criteria construction. Select the condition to be applied to the field.
Conditions Criteria Value The value of the field to be compared.
Row Count Number of rows to be returned 100
Page Page number to be returned 1
Fetch All Fetch all the data. If true, it will ignore Row Count and Page inputs. true
Connection

List Configuration Items {#listconfigurationitems}

Retrieve a list of all configuration items on the CMDB

Input Comments Default
CI Type API Name Denotes the unique identifier used to identify the CI.
Conditions Criteria Conditions are the operators for criteria construction. Select the condition to be applied to the field.
Conditions Criteria Value The value of the field to be compared.
Row Count Number of rows to be returned 100
Page Page number to be returned 1
Fetch All Fetch all the data. If true, it will ignore Row Count and Page inputs. true
Connection

List Problem Notes {#listproblemnotes}

Retrieve a list of problem notes

Input Comments Default
Connection
Problem ID ID of the problem.
Fetch All Fetch all the data. If true, it will ignore Row Count and Page inputs. true
Page Page number to be returned 1
Row Count Number of rows to be returned 100
Conditions Criteria Conditions are the operators for criteria construction. Select the condition to be applied to the field.
Conditions Criteria Value The value of the field to be compared.

List Problems {#listproblems}

Retrieve a list of problems

Input Comments Default
Connection
Fetch All Fetch all the data. If true, it will ignore Row Count and Page inputs. true
Row Count Number of rows to be returned 100
Page Page number to be returned 1
Conditions Criteria Conditions are the operators for criteria construction. Select the condition to be applied to the field.
Conditions Criteria Value The value of the field to be compared.

List Problem Tasks {#listproblemtasks}

Retrieve a list of problem tasks

Input Comments Default
Connection
Problem ID ID of the problem.
Fetch All Fetch all the data. If true, it will ignore Row Count and Page inputs. true
Page Page number to be returned 1
Row Count Number of rows to be returned 100
Conditions Criteria Conditions are the operators for criteria construction. Select the condition to be applied to the field.
Conditions Criteria Value The value of the field to be compared.

List Products {#listproducts}

Retrieve a list of products

Input Comments Default
Conditions Criteria Conditions are the operators for criteria construction. Select the condition to be applied to the field.
Conditions Criteria Value The value of the field to be compared.
Row Count Number of rows to be returned 100
Page Page number to be returned 1
Fetch All Fetch all the data. If true, it will ignore Row Count and Page inputs. true
Connection

List Product Types {#listproducttypes}

Retrieve a list of product types

Input Comments Default
Conditions Criteria Conditions are the operators for criteria construction. Select the condition to be applied to the field.
Conditions Criteria Value The value of the field to be compared.
Row Count Number of rows to be returned 100
Page Page number to be returned 1
Fetch All Fetch all the data. If true, it will ignore Row Count and Page inputs. true
Connection

List Requests {#listrequests}

Retrieve a list of requests

Input Comments Default
Connection
Fetch All Fetch all the data. If true, it will ignore Row Count and Page inputs. true
Row Count Number of rows to be returned 100
Page Page number to be returned 1
Conditions Criteria Conditions are the operators for criteria construction. Select the condition to be applied to the field.
Conditions Criteria Value The value of the field to be compared.

List Request Tasks {#listrequesttasks}

Retrieve a list of request tasks

Input Comments Default
Connection
Request ID ID of the request.
Fetch All Fetch all the data. If true, it will ignore Row Count and Page inputs. true
Row Count Number of rows to be returned 100
Page Page number to be returned 1
Conditions Criteria Conditions are the operators for criteria construction. Select the condition to be applied to the field.
Conditions Criteria Value The value of the field to be compared.

Raw Request {#rawrequest}

Send raw HTTP request to ServiceDesk Plus

Input Comments Default
Connection
URL This is the URL to call.
Method The HTTP method to use.
Data The HTTP body payload to send to the URL.
Form Data The Form Data to be sent as a multipart form upload.
File Data File Data to be sent as a multipart form upload.
File Data File Names File names to apply to the file data inputs. Keys must match the file data keys above.
Query Parameter A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
Header A list of headers to send with the request.
Response Type The type of data you expect in the response. You can request json, text, or binary data. json
Timeout The maximum time that a client will await a response to its request
Debug Request Enable this to log the request and response false
Retry Delay (ms) The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled. 0
Retry On All Errors If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors. false
Max Retry Count The maximum number of retries to attempt. Specify 0 for no retries. 0
Use Exponential Backoff Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored. false

Update Asset {#updateasset}

Edit an existing asset

Input Comments Default
Asset ID Unique identifier to identify the asset
Asset Name Unique name to identify the asset
State Indicates the state of the asset. Remove the default value if not needed. {
"name": "test-state",
"id": "234567890123456"
}
Product Product of the asset. Remove the default value if not needed. {
"name": "test-product",
"id": "234567890123456"
}
Asset Tag Asset tag used to identify the asset
State History Comments A text in a plain format. No rich text or new line characters allowed.
Bar Code Unique barcode used to identify the asset
Attributes Other attributes to add to the payload
Connection

Update Configuration Item {#updateconfigurationitem}

Edit an existing configuration item on the CMDB

Input Comments Default
CI Type API Name Denotes the unique identifier used to identify the CI.
CI ID Denotes the unique identifier used to identify the CI.
Description Description of the CI
Attributes Other attributes to add to the payload {
"txt_ip_address": "127.0.0.1"
}
Connection

Update Problem {#updateproblem}

Update an existing problem

Input Comments Default
Connection
To Update Problem ID ID of the problem to be updated.
Problem Title Title of the problem.
Problem Description Description of the problem.
Problem Reported Time Indicates the reported time of the problem. See ServiceDesk Plus API documentation for details.
Problem Due By Time Indicates the due by time of the problem. See ServiceDesk Plus API documentation for details.
Problem Closed Time Indicates the closed time of the problem. See ServiceDesk Plus API documentation for details.
Additional Fields Additional fields that might not be covered by the standard inputs. See ServiceDesk Plus API documentation for details.

Update Problem Note {#updateproblemnote}

Update a problem note

Input Comments Default
Connection
Problem ID ID of the problem.
To Update Note ID ID of the note to be updated.
Note Description Contains description about the note.
Notify To Contains info on users or roles to be notified on add/edit operation of the note. See ServiceDesk Plus API documentation for details.
Additional Fields Additional fields that might not be covered by the standard inputs. See ServiceDesk Plus API documentation for details.

Update Problem Task {#updateproblemtask}

Update a problem task

Input Comments Default
Connection
Problem ID ID of the problem.
To Update Task ID ID of the task to be updated.
Task Title Title of the task.
Task Description Contains description about the task.
Task Type Used to categorize the tasks of similar cases. See ServiceDesk Plus API documentation for details.
Owner The User assigned to the task. See ServiceDesk Plus API documentation for details.
Estimated Effort Minutes Estimated number of minutes to finish the task.
Estimated Effort Hours Estimated number of hours to finish the task.
Estimated Effort Days Estimated number of days to finish the task.
Percentage Completion Indicates the progress of the task in percentage of completion.
Group Indicates the assigned group of the task. See ServiceDesk Plus API documentation for details.
Additional Fields Additional fields that might not be covered by the standard inputs. See ServiceDesk Plus API documentation for details.

Update Product {#updateproduct}

Updates an existing product

Input Comments Default
ID Unique identifier to identify the resource
Product Type Product type of the product. Remove the default value if not needed. {
"name": "test-product_type",
"id": "234567890123456"
}
Name Unique identifier to identify the resource
Manufacturer Name to identify the product manufacturer.
Is Laptop Boolean value indicating whether the product type is laptop or not.
Part No Part no of the productPart no of the product
Attributes Other attributes to add to the payload
Connection

Update Product Type {#updateproducttype}

Updates an existing product type

Input Comments Default
ID Unique identifier to identify the resource
Name Unique identifier to identify the resource
Category Category of the product type. Remove the default value if not needed. {
"name": "Non-IT",
"id": "234567890123456"
}
Asset Type Type of the product type. Remove the default value if not needed. {
"name": "Asset",
"id": "234567890123456"
}
Attributes Other attributes to add to the payload
Connection

Update Request {#updaterequest}

Update a request

Input Comments Default
Connection
To Update Request ID ID of the request to be updated.
Request Subject Subject of this request.
Request Description Description of this request.
Impact Details Description about the impact of this request.
Email IDs To Notify Email ids, which needs to be notified about the happenings of this request.
Delete Pre Template Tasks Boolean value indicating whether the pre template tasks need to be deleted. false
Additional Fields Additional fields that might not be covered by the standard inputs. See ServiceDesk Plus API documentation for details.

Update Request Task {#updaterequesttask}

Update a request task

Input Comments Default
Connection
Request ID ID of the request.
To Update Request Task ID ID of the task to be updated.
Request Task Title Title of the task.
Request Task Percentage Completion Indicates the progress of the task in percentage of completion.
Request Task Estimated Effort Hours Estimated number of hours to finish the task.
Request Task Description Contains description about the task.
Request Task Owner The User assigned to the task. See ServiceDesk Plus API documentation for details.
Request Task Additional Cost Cost spent other than the actual cost of the task.
Request Task Actual End Time Date and time at which the task actually got finished. See ServiceDesk Plus API documentation for details.
Request Task Actual Start Time Date and time at which the task actually got started. See ServiceDesk Plus API documentation for details.
Additional Fields Additional fields that might not be covered by the standard inputs. See ServiceDesk Plus API documentation for details.