ManageEngine ServiceDesk Plus

Use cases and templates: ManageEngine ServiceDesk Plus integration for AI agents

Use ManageEngine ServiceDesk Plus Cloud to manage requests, problems, changes, assets, and knowledge-base solutions through its v3 REST API. The 31 operations cover create, read, list, update, and delete across those modules, plus request, problem, and change notes.

Lookup fields such as status, priority, category, technician, group, topic, and product use names or email addresses. Custom fields use the udf_* keys. Use search_criteria for server-side filtering with text, numeric, and date comparisons; for example, sort requests by due_by_time to find approaching deadlines. Solutions and requester-visible notes can support ticket replies; resolved requests and notes can supply a new knowledge-base article.

Before you start

Connect your Zoho account from the block's credential field. Self-hosted deployments additionally need Sim's Zoho OAuth client configured in the Zoho API console. The same client serves Zoho Desk and ServiceDesk Plus — Zoho scopes are chosen per authorization request, not per registered client, so no second app is needed.

Three things shape what will work:

• Data center. Connecting requires a Zoho account in the US data center. Sim's authorize and token-exchange legs are pinned to accounts.zoho.com, and a Zoho access token is only valid in the data center that issued it. The Data Center field lists every documented host (US, EU, IN, AU, JP, CA, SA, UK, CN, AE) because that mapping is stable, but only US is reachable with a credential connected through Sim today.
• Portal. Accounts with more than one portal must set the Portal field to the portal's URL name — found under ESM Directory → Service Desk Instances. Leaving it empty addresses the account's default portal.
• Scopes. The connection requests SDPOnDemand.{requests,problems,changes,assets,solutions} at the exact verbs these operations use, plus aaaserver.profile.READ to label the credential. Nothing broader is requested, so an operation whose module your Zoho user cannot access will fail at ServiceDesk Plus rather than being silently skipped.

Updates and pagination

• Required fields differ per module. Requests need a subject; problems a title; changes a title, stage, and status; assets a name and an existing product; solutions a title, content, and an existing topic.
• Editing a change's status requires a comment. ServiceDesk Plus rejects the update otherwise, so the Status Comment field sits alongside the status on Update Change.
• Updates only send what you fill in. Fields left empty are omitted from the request rather than sent as null, so changing a status never clears the technician or category. The two flags that cannot express this with a toggle — Emergency Change and Visible to Requesters — become Leave unchanged / Yes / No dropdowns on their update operations for the same reason.
• A solution only becomes requester-visible once approved. ServiceDesk Plus ignores is_public until the article's approval status is Approved.
• Lists cap at 100 rows. Row Count is clamped to the documented maximum; page with Start Index and watch has_more_rows in the returned listInfo. Set Include Total Count when you need the true size of a queue rather than the page size.
• The standalone Tasks module is not covered. Its endpoints are documented but the ServiceDesk Plus scope table publishes no tasks entry, so requesting one would put an unverified scope on the consent screen.

OAuth scopes

Sim requests these scopes when someone connects a ManageEngine ServiceDesk Plus account. For a self-hosted deployment, register your own app with the provider using the settings below. See Integrations and OAuth for setup.

Use the block

Full read and write access to ManageEngine ServiceDesk Plus Cloud: create, search, update and delete requests, problems, changes, assets and knowledge base solutions, and add notes to requests, problems and changes. Supports multi-portal accounts. Connecting requires a Zoho account in the US data center.

Actions

ManageEngine SDP Create Request

Create a request (ticket) in ManageEngine ServiceDesk Plus Cloud with a subject, description, requester and classification.

Input

Output

ManageEngine SDP Get Request

Retrieve a single ManageEngine ServiceDesk Plus Cloud request by ID.

Input

Output

ManageEngine SDP List Requests

List ManageEngine ServiceDesk Plus Cloud requests, with optional search criteria, sorting and paging.

Input

Output

ManageEngine SDP Update Request

Update a ManageEngine ServiceDesk Plus Cloud request: change its status, priority, assignment, classification or description.

Input

Output

ManageEngine SDP Delete Request

Move a ManageEngine ServiceDesk Plus Cloud request to the trash. Deleting a request also removes its notes, tasks and worklogs.

Input

Output

ManageEngine SDP Add Request Note

Add a note to a ManageEngine ServiceDesk Plus Cloud request, optionally making it visible to the requester.

Input

Output

ManageEngine SDP List Request Notes

List the notes on a ManageEngine ServiceDesk Plus Cloud request.

Input

Output

ManageEngine SDP Create Problem

Create a problem record in ManageEngine ServiceDesk Plus Cloud with a title, description and classification.

Input

Output

ManageEngine SDP Get Problem

Retrieve a single ManageEngine ServiceDesk Plus Cloud problem by ID.

Input

Output

ManageEngine SDP List Problems

List ManageEngine ServiceDesk Plus Cloud problems, with optional search criteria, sorting and paging.

Input

Output

ManageEngine SDP Update Problem

Update a ManageEngine ServiceDesk Plus Cloud problem: change its title, status, assignment or classification.

Input

Output

ManageEngine SDP Delete Problem

Delete a ManageEngine ServiceDesk Plus Cloud problem and its associated notes.

Input

Output

ManageEngine SDP Add Problem Note

Add a note to a ManageEngine ServiceDesk Plus Cloud problem.

Input

Output

ManageEngine SDP List Problem Notes

List the notes on a ManageEngine ServiceDesk Plus Cloud problem.

Input

Output

ManageEngine SDP Create Change

Create a change record in ManageEngine ServiceDesk Plus Cloud with a title, stage, status and schedule.

Input

Output

ManageEngine SDP Get Change

Retrieve a single ManageEngine ServiceDesk Plus Cloud change by ID.

Input

Output

ManageEngine SDP List Changes

List ManageEngine ServiceDesk Plus Cloud changes, with optional search criteria, sorting and paging.

Input

Output

ManageEngine SDP Update Change

Update a ManageEngine ServiceDesk Plus Cloud change: move its stage or status, reschedule it, or change its assignment. ServiceDesk Plus requires a comment whenever the status changes.

Input

Output

ManageEngine SDP Delete Change

Delete a ManageEngine ServiceDesk Plus Cloud change and its associated notes.

Input

Output

ManageEngine SDP Add Change Note

Add a note to a ManageEngine ServiceDesk Plus Cloud change.

Input

Output

ManageEngine SDP List Change Notes

List the notes on a ManageEngine ServiceDesk Plus Cloud change.

Input

Output

ManageEngine SDP Create Asset

Create an asset in the ManageEngine ServiceDesk Plus Cloud inventory. Requires a name and an existing product.

Input

Output

ManageEngine SDP Get Asset

Retrieve a single ManageEngine ServiceDesk Plus Cloud asset by ID.

Input

Output

ManageEngine SDP List Assets

List ManageEngine ServiceDesk Plus Cloud assets, with optional search criteria, sorting and paging.

Input

Output

ManageEngine SDP Update Asset

Update a ManageEngine ServiceDesk Plus Cloud asset: reassign it, change its state, or correct its inventory details.

Input

Output

ManageEngine SDP Delete Asset

Delete an asset from the ManageEngine ServiceDesk Plus Cloud inventory.

Input

Output

ManageEngine SDP Create Solution

Add an article to the ManageEngine ServiceDesk Plus Cloud knowledge base under an existing topic.

Input

Output

ManageEngine SDP Get Solution

Retrieve a single ManageEngine ServiceDesk Plus Cloud knowledge base solution by ID.

Input

Output

ManageEngine SDP List Solutions

Search the ManageEngine ServiceDesk Plus Cloud knowledge base, with optional search criteria, sorting and paging.

Input

Output

ManageEngine SDP Update Solution

Update a ManageEngine ServiceDesk Plus Cloud knowledge base solution: revise its body, retitle it, or move it to another topic.

Input

Output

ManageEngine SDP Delete Solution

Delete an article from the ManageEngine ServiceDesk Plus Cloud knowledge base, along with its comments and versions.

Input

Output