ServiceDesk Plus Connector

Prev Next
Note on third‑party tools

We aim to provide accurate and helpful details about third‑party tools, but we can’t guarantee that this information is always complete or up to date. If you notice any discrepancies, feel free to share them in the feedback section below. For the most reliable information, please always refer to the third‑party tool’s official documentation.

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

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
    1. Example scopes: SDPOnDemand.cmdb.READ,SDPOnDemand.assets.READ
  4. When the Generated Code is provided, copy and/or download the code and enter in the connection configuration of the integration.
  5. 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.flowbuilder.eu.lansweeper.com/callback for EU sites or https://oauth2.flowbuilder.us.lansweeper.com/callback for US sites
  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

Triggers

New Records

Checks for new records in ServiceDesk Plus on a configured schedule.

Input Comments Default
Connection
Resource Type The type of resource to poll for new records. requests
Show New Records Include records that are new since the last poll. true

Actions

Create Asset

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
Additional Fields Additional optional fields: includes Asset Tag, State History Comments, Bar Code.
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

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

Create a new problem

Input Comments Default
Connection
Problem Title Title of the problem.
Problem Description Description of the problem.
Problem Times Reported, due by, and closed times.
Reported Time Indicates the reported time of the problem. See ServiceDesk Plus API documentation for details.
Due By Time Indicates the due by time of the problem. See ServiceDesk Plus API documentation for details.
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

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

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 Estimated minutes, hours, and days to finish.
Minutes Estimated number of minutes to finish the task.
Hours Estimated number of hours to finish the task.
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

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
Product Details Manufacturer, laptop indicator, and part number.
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

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

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

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

Delete an existing asset

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

Delete Configuration Item

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

Delete a problem by ID

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

Delete Problem Note

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

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

Delete a single product

Input Comments Default
ID Unique identifier to identify the resource
Connection

Delete Product Type

Delete a single product type

Input Comments Default
ID Unique identifier to identify the resource
Connection

Delete Request

Delete a request by ID

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

Delete Request Task

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

Retrieve a single asset

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

Get Configuration Item

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

Get a problem by ID

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

Get Problem Note

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

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

Retrieve a single product

Input Comments Default
ID Unique identifier to identify the resource
Connection

Get Product Type

Retrieve a single product type

Input Comments Default
ID Unique identifier to identify the resource
Connection

Get Request

Get a request by ID

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

Get Request Task

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

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.
Pagination Page number and number of rows to return per page.
Page Page number to be returned 1
Row Count Number of rows to be returned 100
Fetch All Fetch all the data. If true, it will ignore Row Count and Page inputs. true
Connection

List Configuration Items

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.
Pagination Page number and number of rows to return per page.
Page Page number to be returned 1
Row Count Number of rows to be returned 100
Fetch All Fetch all the data. If true, it will ignore Row Count and Page inputs. true
Connection

List Problem Notes

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
Pagination Page number and number of rows to return per page.
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

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
Pagination Page number and number of rows to return per page.
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 Problem Tasks

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
Pagination Page number and number of rows to return per page.
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

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.
Pagination Page number and number of rows to return per page.
Page Page number to be returned 1
Row Count Number of rows to be returned 100
Fetch All Fetch all the data. If true, it will ignore Row Count and Page inputs. true
Connection

List Product Types

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.
Pagination Page number and number of rows to return per page.
Page Page number to be returned 1
Row Count Number of rows to be returned 100
Fetch All Fetch all the data. If true, it will ignore Row Count and Page inputs. true
Connection

List Requests

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
Pagination Page number and number of rows to return per page.
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 Request Tasks

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
Pagination Page number and number of rows to return per page.
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.

Raw Request

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

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"
}
Additional Fields Additional optional fields: includes Asset Tag, State History Comments, Bar Code.
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

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

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 Times Reported, due by, and closed times.
Reported Time Indicates the reported time of the problem. See ServiceDesk Plus API documentation for details.
Due By Time Indicates the due by time of the problem. See ServiceDesk Plus API documentation for details.
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

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

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 Estimated minutes, hours, and days to finish.
Minutes Estimated number of minutes to finish the task.
Hours Estimated number of hours to finish the task.
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

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
Product Details Manufacturer, laptop indicator, and part number.
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

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

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

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.