ManageEngine ServiceDesk Plus
App · 20 actions
IT help desk. Raise, update and close requests, add notes, tasks and time logs, and find requests by status, priority or group.
Actions
| Action | What it does |
|---|---|
| Add note | Add a note to a request. |
| Add worklog | Log time spent on a request. |
| Close request | Close a request. |
| Create request | Raise a request (ticket). |
| Create task | Add a task to a request. |
| Delete note | Delete a note from a request. |
| Delete request | Delete a request. |
| Delete task | Delete a task from a request. |
| Delete worklog | Delete a worklog from a request. |
| Get note | Get one note on a request. |
| Get request | Get one request: its subject, status, people, dates and resolution. |
| Get task | Get one task on a request. |
| List closure codes | List the closure codes a request can be closed with. |
| List notes | List the notes on a request, oldest first. |
| List requests | List requests, newest first, optionally only those whose subject contains some text or that have a given status, priority or group. |
| List tasks | List the tasks on a request, oldest first. |
| List worklogs | List the time logged on a request, oldest first. |
| Update note | Change a note's text or who can see it. |
| Update request | Change fields on a request. |
| Update task | Change a task. |
Add note
Add a note to a request. It is private to technicians unless you show it to the requester.
Inputs
- Request ID
request_idtextRequired - The request's id: the long number from 'Create request' or 'List requests', or the request's address in ServiceDesk Plus. It is not the short request number shown on screen.
- Note
descriptiontextRequired - What to write.
- Show to requester
show_to_requestertrue/false - Whether the requester can see the note. Off keeps it private to technicians.
- Notify technician
notify_techniciantrue/false - Whether to tell the request's technician about the note.
Outputs
noteobject- The new note
Example output
{
"note": {
"created_by_email": "charles@example.com",
"created_by_id": "1994035670863379",
"created_by_name": "Charles",
"created_time": "2026-10-20T10:00:00.000Z",
"description": "<div>Called the requester; monitor ordered.</div>",
"id": "1997129173325228",
"notify_technician": false,
"request_id": "2079997951635005",
"show_to_requester": false
}
}Add worklog
Log time spent on a request. The time spent is worked out from the start and end.
Inputs
- Request ID
request_idtextRequired - The request's id: the long number from 'Create request' or 'List requests', or the request's address in ServiceDesk Plus. It is not the short request number shown on screen.
- Technician
ownertextRequired - Who did the work, by email address.
- Started
start_timedate and timeRequired - When the work started.
- Ended
end_timedate and timeRequired - When the work ended. Must be after it started.
- Description
descriptiontext - What was done.
Outputs
worklogobject- The new worklog
Example output
{
"worklog": {
"created_time": "2026-10-21T10:31:00.000Z",
"description": "Set up the monitor",
"end_time": "2026-10-21T10:30:00.000Z",
"hours_spent": 1,
"id": "2000000040351",
"minutes_spent": 30,
"owner_email": "charles@example.com",
"owner_id": "1537931074919595",
"owner_name": "Charles",
"start_time": "2026-10-21T09:00:00.000Z"
}
}Close request
Close a request. Your portal may insist on a resolution or a closure code before it lets a request close.
Inputs
- Request ID
request_idtextRequired - The request's id: the long number from 'Create request' or 'List requests', or the request's address in ServiceDesk Plus. It is not the short request number shown on screen.
- Closure code
closure_codetext - Why it is closed, such as Success.
- Closure comments
closure_commentstext - A note on why the request is closed.
- Resolution
resolutiontext - The resolution text, saved on the request.
Outputs
requestobject- The closed request
Example output
{
"request": {
"category": "Hardware",
"completed_time": null,
"created_time": "2026-10-20T09:00:00.000Z",
"description": "<div>Provide me an External Monitor</div>",
"display_id": "39",
"due_by_time": "2026-10-27T09:00:00.000Z",
"group": "Hardware Problems",
"has_notes": false,
"id": "2079997951635005",
"impact": "Affects Business",
"is_overdue": false,
"is_service_request": false,
"item": null,
"last_updated_time": "2026-10-20T09:00:00.000Z",
"level": "Tier 1",
"mode": "Web Form",
"priority": "High",
"request_type": "Service Request",
"requester_email": "lincoln@example.com",
"requester_id": "1650986973829395",
"requester_name": "Lincoln",
"resolution": null,
"resolved_time": null,
"site": null,
"status": "Closed",
"subcategory": null,
"subject": "Need an External Monitor",
"technician_email": "charles@example.com",
"technician_id": "1537931074919595",
"technician_name": "Charles",
"urgency": "Urgent"
}
}Create request
Raise a request (ticket). Only the subject is required; ServiceDesk Plus fills in the rest from its defaults.
Inputs
- Subject
subjecttextRequired - One line saying what the request is about.
- Description
descriptiontext - The details of the request.
- Requester
requestertext - Who the request is for, by email address. Leave empty for the connected user.
- Status
statustext - The status, such as Open. Pick one or type its name.
- Priority
prioritytext - The priority.
- Urgency
urgencytext - The urgency.
- Impact
impacttext - The impact.
- Type
request_typetext - The type, such as Incident or Service Request.
- Mode
modetext - How the request was raised, such as E-Mail.
- Level
leveltext - The support level, such as Tier 1.
- Category
categorytext - The category.
- Subcategory
subcategorytext - The subcategory, typed as named in ServiceDesk Plus. It must belong to the category.
- Item
itemtext - The item, typed as named in ServiceDesk Plus. It must belong to the subcategory.
- Group
grouptext - The support group to assign it to.
- Technician
techniciantext - The technician to assign it to, by email address.
- Due date
due_by_timedate and time - When the request is due.
Outputs
requestobject- The new request
Example output
{
"request": {
"category": "Hardware",
"completed_time": null,
"created_time": "2026-10-20T09:00:00.000Z",
"description": "<div>Provide me an External Monitor</div>",
"display_id": "39",
"due_by_time": "2026-10-27T09:00:00.000Z",
"group": "Hardware Problems",
"has_notes": false,
"id": "2079997951635005",
"impact": "Affects Business",
"is_overdue": false,
"is_service_request": false,
"item": null,
"last_updated_time": "2026-10-20T09:00:00.000Z",
"level": "Tier 1",
"mode": "Web Form",
"priority": "High",
"request_type": "Service Request",
"requester_email": "lincoln@example.com",
"requester_id": "1650986973829395",
"requester_name": "Lincoln",
"resolution": null,
"resolved_time": null,
"site": null,
"status": "Open",
"subcategory": null,
"subject": "Need an External Monitor",
"technician_email": "charles@example.com",
"technician_id": "1537931074919595",
"technician_name": "Charles",
"urgency": "Urgent"
}
}Create task
Add a task to a request.
Inputs
- Request ID
request_idtextRequired - The request's id: the long number from 'Create request' or 'List requests', or the request's address in ServiceDesk Plus. It is not the short request number shown on screen.
- Title
titletextRequired - What the task is.
- Description
descriptiontext - The details of the task.
- Owner
ownertext - Who does the task, by email address.
- Status
statustext - The task's status, such as Open.
- Priority
prioritytext - The task's priority.
- Scheduled start
scheduled_start_timedate and time - When the task is scheduled to start.
- Scheduled end
scheduled_end_timedate and time - When the task is scheduled to end.
Outputs
taskobject- The new task
Example output
{
"task": {
"created_time": "2026-10-20T10:30:00.000Z",
"description": null,
"id": "2174353095375675",
"owner_email": "charles@example.com",
"owner_id": "1537931074919595",
"owner_name": "Charles",
"percentage_completion": 0,
"priority": "High",
"request_id": "2079997951635005",
"scheduled_end_time": "2026-10-22T09:00:00.000Z",
"scheduled_start_time": "2026-10-21T09:00:00.000Z",
"status": "Open",
"title": "Order the monitor"
}
}Delete note
Delete a note from a request.
Inputs
- Request ID
request_idtextRequired - The request's id: the long number from 'Create request' or 'List requests', or the request's address in ServiceDesk Plus. It is not the short request number shown on screen.
- Note ID
note_idtextRequired - The note's id, from 'Add note' or 'List notes'.
Outputs
deletedtrue/false- Always true once deleted
note_idtext- The note deleted
Example output
{
"deleted": true,
"note_id": "1997129173325228"
}Delete request
Delete a request.
Inputs
- Request ID
request_idtextRequired - The request's id: the long number from 'Create request' or 'List requests', or the request's address in ServiceDesk Plus. It is not the short request number shown on screen.
Outputs
deletedtrue/false- Always true once deleted
request_idtext- The request deleted
Example output
{
"deleted": true,
"request_id": "2079997951635005"
}Delete task
Delete a task from a request.
Inputs
- Request ID
request_idtextRequired - The request's id: the long number from 'Create request' or 'List requests', or the request's address in ServiceDesk Plus. It is not the short request number shown on screen.
- Task ID
task_idtextRequired - The task's id, from 'Create task' or 'List tasks'.
Outputs
deletedtrue/false- Always true once deleted
task_idtext- The task deleted
Example output
{
"deleted": true,
"task_id": "2174353095375675"
}Delete worklog
Delete a worklog from a request.
Inputs
- Request ID
request_idtextRequired - The request's id: the long number from 'Create request' or 'List requests', or the request's address in ServiceDesk Plus. It is not the short request number shown on screen.
- Worklog ID
worklog_idtextRequired - The worklog's id, from 'Add worklog' or 'List worklogs'.
Outputs
deletedtrue/false- Always true once deleted
worklog_idtext- The worklog deleted
Example output
{
"deleted": true,
"worklog_id": "2000000040351"
}Get note
Get one note on a request.
Inputs
- Request ID
request_idtextRequired - The request's id: the long number from 'Create request' or 'List requests', or the request's address in ServiceDesk Plus. It is not the short request number shown on screen.
- Note ID
note_idtextRequired - The note's id, from 'Add note' or 'List notes'.
Outputs
noteobject- The note
Example output
{
"note": {
"created_by_email": "charles@example.com",
"created_by_id": "1994035670863379",
"created_by_name": "Charles",
"created_time": "2026-10-20T10:00:00.000Z",
"description": "<div>Called the requester; monitor ordered.</div>",
"id": "1997129173325228",
"notify_technician": false,
"request_id": "2079997951635005",
"show_to_requester": false
}
}Get request
Get one request: its subject, status, people, dates and resolution.
Inputs
- Request ID
request_idtextRequired - The request's id: the long number from 'Create request' or 'List requests', or the request's address in ServiceDesk Plus. It is not the short request number shown on screen.
Outputs
requestobject- The request
Example output
{
"request": {
"category": "Hardware",
"completed_time": null,
"created_time": "2026-10-20T09:00:00.000Z",
"description": "<div>Provide me an External Monitor</div>",
"display_id": "39",
"due_by_time": "2026-10-27T09:00:00.000Z",
"group": "Hardware Problems",
"has_notes": false,
"id": "2079997951635005",
"impact": "Affects Business",
"is_overdue": false,
"is_service_request": false,
"item": null,
"last_updated_time": "2026-10-20T09:00:00.000Z",
"level": "Tier 1",
"mode": "Web Form",
"priority": "High",
"request_type": "Service Request",
"requester_email": "lincoln@example.com",
"requester_id": "1650986973829395",
"requester_name": "Lincoln",
"resolution": null,
"resolved_time": null,
"site": null,
"status": "Open",
"subcategory": null,
"subject": "Need an External Monitor",
"technician_email": "charles@example.com",
"technician_id": "1537931074919595",
"technician_name": "Charles",
"urgency": "Urgent"
}
}Get task
Get one task on a request.
Inputs
- Request ID
request_idtextRequired - The request's id: the long number from 'Create request' or 'List requests', or the request's address in ServiceDesk Plus. It is not the short request number shown on screen.
- Task ID
task_idtextRequired - The task's id, from 'Create task' or 'List tasks'.
Outputs
taskobject- The task
Example output
{
"task": {
"created_time": "2026-10-20T10:30:00.000Z",
"description": null,
"id": "2174353095375675",
"owner_email": "charles@example.com",
"owner_id": "1537931074919595",
"owner_name": "Charles",
"percentage_completion": 0,
"priority": "High",
"request_id": "2079997951635005",
"scheduled_end_time": "2026-10-22T09:00:00.000Z",
"scheduled_start_time": "2026-10-21T09:00:00.000Z",
"status": "Open",
"title": "Order the monitor"
}
}List closure codes
List the closure codes a request can be closed with.
Inputs
None.
Outputs
closure_codeslist- The closure codes
countnumber- How many
Example output
{
"closure_codes": [
{
"id": "2000000008001",
"name": "Success"
}
],
"count": 1
}List notes
List the notes on a request, oldest first. Returns one page.
Inputs
- Request ID
request_idtextRequired - The request's id: the long number from 'Create request' or 'List requests', or the request's address in ServiceDesk Plus. It is not the short request number shown on screen.
- Page size
limitnumber - How many to return, 1 to 100. Defaults to 25.From 1 to 100.
- Start index
start_indexnumber - Where to start, to get a later page. Use 'next_start_index' from the page before. Defaults to 1.At least 1.
Outputs
countnumber- How many came back in this page
has_moretrue/false- Whether there are more after this page
next_start_indexnumber- Give this as 'Start index' to get the next page
noteslist- The notes
Example output
{
"count": 1,
"has_more": false,
"next_start_index": null,
"notes": [
{
"created_by_email": "charles@example.com",
"created_by_id": "1994035670863379",
"created_by_name": "Charles",
"created_time": "2026-10-20T10:00:00.000Z",
"description": "<div>Called the requester; monitor ordered.</div>",
"id": "1997129173325228",
"notify_technician": false,
"request_id": "2079997951635005",
"show_to_requester": false
}
]
}List requests
List requests, newest first, optionally only those whose subject contains some text or that have a given status, priority or group. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Subject contains
subject_containstext - Only requests whose subject contains this text.
- Status
statustext - Only requests with this status.
- Priority
prioritytext - Only requests with this priority.
- Group
grouptext - Only requests assigned to this group.
- Sort by
sort_bytext - What to order the requests by.One of:
created_time(Date created (default)),last_updated_time(Date last updated),due_by_time(Due date),subject,id. Default:created_time. - Order
sort_ordertext - Which end to start from.One of:
desc(Newest first (default)),asc(Oldest first). Default:desc. - Page size
limitnumber - How many to return, 1 to 100. Defaults to 25.From 1 to 100.
- Start index
start_indexnumber - Where to start, to get a later page. Use 'next_start_index' from the page before. Defaults to 1.At least 1.
Outputs
countnumber- How many came back in this page
has_moretrue/false- Whether there are more after this page
next_start_indexnumber- Give this as 'Start index' to get the next page
requestslist- The requests
Example output
{
"count": 1,
"has_more": false,
"next_start_index": null,
"requests": [
{
"category": "Hardware",
"completed_time": null,
"created_time": "2026-10-20T09:00:00.000Z",
"description": "<div>Provide me an External Monitor</div>",
"display_id": "39",
"due_by_time": "2026-10-27T09:00:00.000Z",
"group": "Hardware Problems",
"has_notes": false,
"id": "2079997951635005",
"impact": "Affects Business",
"is_overdue": false,
"is_service_request": false,
"item": null,
"last_updated_time": "2026-10-20T09:00:00.000Z",
"level": "Tier 1",
"mode": "Web Form",
"priority": "High",
"request_type": "Service Request",
"requester_email": "lincoln@example.com",
"requester_id": "1650986973829395",
"requester_name": "Lincoln",
"resolution": null,
"resolved_time": null,
"site": null,
"status": "Open",
"subcategory": null,
"subject": "Need an External Monitor",
"technician_email": "charles@example.com",
"technician_id": "1537931074919595",
"technician_name": "Charles",
"urgency": "Urgent"
}
]
}List tasks
List the tasks on a request, oldest first. Returns one page.
Inputs
- Request ID
request_idtextRequired - The request's id: the long number from 'Create request' or 'List requests', or the request's address in ServiceDesk Plus. It is not the short request number shown on screen.
- Page size
limitnumber - How many to return, 1 to 100. Defaults to 25.From 1 to 100.
- Start index
start_indexnumber - Where to start, to get a later page. Use 'next_start_index' from the page before. Defaults to 1.At least 1.
Outputs
countnumber- How many came back in this page
has_moretrue/false- Whether there are more after this page
next_start_indexnumber- Give this as 'Start index' to get the next page
taskslist- The tasks
Example output
{
"count": 1,
"has_more": false,
"next_start_index": null,
"tasks": [
{
"created_time": "2026-10-20T10:30:00.000Z",
"description": null,
"id": "2174353095375675",
"owner_email": "charles@example.com",
"owner_id": "1537931074919595",
"owner_name": "Charles",
"percentage_completion": 0,
"priority": "High",
"request_id": "2079997951635005",
"scheduled_end_time": "2026-10-22T09:00:00.000Z",
"scheduled_start_time": "2026-10-21T09:00:00.000Z",
"status": "Open",
"title": "Order the monitor"
}
]
}List worklogs
List the time logged on a request, oldest first. Returns one page.
Inputs
- Request ID
request_idtextRequired - The request's id: the long number from 'Create request' or 'List requests', or the request's address in ServiceDesk Plus. It is not the short request number shown on screen.
- Page size
limitnumber - How many to return, 1 to 100. Defaults to 25.From 1 to 100.
- Start index
start_indexnumber - Where to start, to get a later page. Use 'next_start_index' from the page before. Defaults to 1.At least 1.
Outputs
countnumber- How many came back in this page
has_moretrue/false- Whether there are more after this page
next_start_indexnumber- Give this as 'Start index' to get the next page
worklogslist- The worklogs
Example output
{
"count": 1,
"has_more": false,
"next_start_index": null,
"worklogs": [
{
"created_time": "2026-10-21T10:31:00.000Z",
"description": "Set up the monitor",
"end_time": "2026-10-21T10:30:00.000Z",
"hours_spent": 1,
"id": "2000000040351",
"minutes_spent": 30,
"owner_email": "charles@example.com",
"owner_id": "1537931074919595",
"owner_name": "Charles",
"start_time": "2026-10-21T09:00:00.000Z"
}
]
}Update note
Change a note's text or who can see it. Only the fields you fill in change.
Inputs
- Request ID
request_idtextRequired - The request's id: the long number from 'Create request' or 'List requests', or the request's address in ServiceDesk Plus. It is not the short request number shown on screen.
- Note ID
note_idtextRequired - The note's id, from 'Add note' or 'List notes'.
- Note
descriptiontext - The new text. Leave empty to keep it.
- Show to requester
show_to_requestertrue/false - Whether the requester can see the note. Off keeps it private to technicians.
- Notify technician
notify_techniciantrue/false - Whether to tell the request's technician about the note.
Outputs
noteobject- The note as saved
Example output
{
"note": {
"created_by_email": "charles@example.com",
"created_by_id": "1994035670863379",
"created_by_name": "Charles",
"created_time": "2026-10-20T10:00:00.000Z",
"description": "<div>Called the requester; monitor ordered.</div>",
"id": "1997129173325228",
"notify_technician": false,
"request_id": "2079997951635005",
"show_to_requester": false
}
}Update request
Change fields on a request. Only the fields you fill in change.
Inputs
- Request ID
request_idtextRequired - The request's id: the long number from 'Create request' or 'List requests', or the request's address in ServiceDesk Plus. It is not the short request number shown on screen.
- Subject
subjecttext - A new subject. Leave empty to keep it.
- Description
descriptiontext - The details of the request.
- Requester
requestertext - Who the request is for, by email address. Leave empty for the connected user.
- Status
statustext - The status, such as Open. Pick one or type its name.
- Priority
prioritytext - The priority.
- Urgency
urgencytext - The urgency.
- Impact
impacttext - The impact.
- Type
request_typetext - The type, such as Incident or Service Request.
- Mode
modetext - How the request was raised, such as E-Mail.
- Level
leveltext - The support level, such as Tier 1.
- Category
categorytext - The category.
- Subcategory
subcategorytext - The subcategory, typed as named in ServiceDesk Plus. It must belong to the category.
- Item
itemtext - The item, typed as named in ServiceDesk Plus. It must belong to the subcategory.
- Group
grouptext - The support group to assign it to.
- Technician
techniciantext - The technician to assign it to, by email address.
- Due date
due_by_timedate and time - When the request is due.
- Resolution
resolutiontext - The resolution text, saved on the request.
Outputs
requestobject- The request as saved
Example output
{
"request": {
"category": "Hardware",
"completed_time": null,
"created_time": "2026-10-20T09:00:00.000Z",
"description": "<div>Provide me an External Monitor</div>",
"display_id": "39",
"due_by_time": "2026-10-27T09:00:00.000Z",
"group": "Hardware Problems",
"has_notes": false,
"id": "2079997951635005",
"impact": "Affects Business",
"is_overdue": false,
"is_service_request": false,
"item": null,
"last_updated_time": "2026-10-20T09:00:00.000Z",
"level": "Tier 1",
"mode": "Web Form",
"priority": "High",
"request_type": "Service Request",
"requester_email": "lincoln@example.com",
"requester_id": "1650986973829395",
"requester_name": "Lincoln",
"resolution": null,
"resolved_time": null,
"site": null,
"status": "Open",
"subcategory": null,
"subject": "Need an External Monitor",
"technician_email": "charles@example.com",
"technician_id": "1537931074919595",
"technician_name": "Charles",
"urgency": "Urgent"
}
}Update task
Change a task. Only the fields you fill in change.
Inputs
- Request ID
request_idtextRequired - The request's id: the long number from 'Create request' or 'List requests', or the request's address in ServiceDesk Plus. It is not the short request number shown on screen.
- Task ID
task_idtextRequired - The task's id, from 'Create task' or 'List tasks'.
- Title
titletext - What the task is.
- Description
descriptiontext - The details of the task.
- Owner
ownertext - Who does the task, by email address.
- Status
statustext - The task's status, such as Open.
- Priority
prioritytext - The task's priority.
- Scheduled start
scheduled_start_timedate and time - When the task is scheduled to start.
- Scheduled end
scheduled_end_timedate and time - When the task is scheduled to end.
- Percentage complete
percentage_completionnumber - How much of the task is done, 0 to 100.From 0 to 100.
Outputs
taskobject- The task as saved
Example output
{
"task": {
"created_time": "2026-10-20T10:30:00.000Z",
"description": null,
"id": "2174353095375675",
"owner_email": "charles@example.com",
"owner_id": "1537931074919595",
"owner_name": "Charles",
"percentage_completion": 0,
"priority": "High",
"request_id": "2079997951635005",
"scheduled_end_time": "2026-10-22T09:00:00.000Z",
"scheduled_start_time": "2026-10-21T09:00:00.000Z",
"status": "Open",
"title": "Order the monitor"
}
}