Zoho Desk

Create, update, search, and comment on support tickets in Zoho Desk.

Adds a public or private comment to a Zoho Desk ticket.

Parameters

Parameter	Type	Required	Description
`ticket_id`	string	No	Zoho Desk ticket ID to update.
`content`	string	No	Comment content to add to the ticket.
`is_public`	boolean	No	Set to true to make the comment public, or false to keep it internal.

Response

{
  "comment_id": "67890",
  "ticket_id": "12345"
}

Creates a Zoho Desk ticket with subject, department, optional contact email, description, priority, and status.

Parameters

Parameter	Type	Required	Description
`subject`	string	No	Ticket subject summarizing the request.
`department_id`	string	No	The Zoho Desk department ID for the ticket.
`contact_email`	string	No	Email address of the person requesting help.
`description`	string	No	Detailed description of the issue.
`priority`	string	No	Optional priority such as Low, High, or Urgent.
`status`	string	No	Optional initial status for the ticket.

Response

{
  "created_time": "2024-01-01T00:00:00Z",
  "status": "Open",
  "ticket_id": "12345"
}

Retrieves details for a specific Zoho Desk ticket.

Parameters

Parameter	Type	Required	Description
`ticket_id`	string	No	Zoho Desk ticket ID to look up.

Response

{
  "departmentId": "dept1",
  "id": "12345",
  "status": "Open",
  "subject": "Test ticket"
}

Lists Zoho Desk tickets with optional department and status filters.

Parameters

Parameter	Type	Required	Description
`limit`	number	No	Maximum number of tickets to return.
`department_id`	string	No	Optional department ID to filter tickets.
`status`	string	No	Optional status filter for tickets.

Response

{
  "count": 1,
  "data": [
    {
      "id": "12345",
      "subject": "Test"
    }
  ]
}

Finds Zoho Desk tickets that match what you search for.

Parameters

Parameter	Type	Required	Description
`search_str`	string	No	What to search for in your tickets.
`limit`	number	No	Maximum number of tickets to return.

Response

{
  "count": 1,
  "data": [
    {
      "id": "12345",
      "subject": "Test"
    }
  ]
}

Updates the status of an existing Zoho Desk ticket.

Parameters

Parameter	Type	Required	Description
`ticket_id`	string	No	Zoho Desk ticket ID to update.
`status`	string	No	New status for the ticket.

Response

{
  "modified_time": "2024-01-01T00:00:00Z",
  "status": "Closed",
  "ticket_id": "12345"
}